> ## Documentation Index
> Fetch the complete documentation index at: https://docs.droplinked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> The Droplinked REST API — base URLs, auth, and conventions.

The Droplinked API is a REST API over JSON. The endpoint pages in this section are generated
from the live OpenAPI specification (`Droplinked APIs`, v1.2) and grouped by domain — shops,
products, carts, orders, collections, customers, subscriptions, AI tools, web3, and more.

## Base URL

```
https://apiv3.droplinked.com        # production
https://apiv3dev.droplinked.com     # development
```

## Authentication

* **Public** endpoints (`/public/…`) need no credentials.
* **Authenticated** endpoints use a Bearer JWT: `Authorization: Bearer <token>`.
* **Integration** (server-to-server) calls use the `integration-api-key` header.

See [Authentication](/authentication) for how to obtain each.

```json theme={null}
"securitySchemes": {
  "bearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" }
}
```

## Conventions

* Responses are wrapped as `{ statusCode, message, data }`; the payload is in `data`.
* List endpoints page with `?page=` and `?limit=`.
* Versioned resources use `v2`/`-v2` paths (e.g. `shops/v2`, `product-v2`, `order-v2`).

<Note>The interactive Swagger UI is available on development at
`https://apiv3dev.droplinked.com/api-doc`. The raw spec backing these pages lives at
`/api-doc-json`.</Note>