GETAPI pública v1

Pedidos (pública)

Lista pedidos da loja para integradores. Escopo orders:read. Envelope público estável.

GET/api/v1/orders

AutenticaçãoChave de APIorders:read.

Chave pública sk_... via Authorization: Bearer, com escopo.

Parâmetros de consulta

Authorizationstringobrigatório
Chave de API pública no formato Bearer sk_live_... (escopo por endpoint).

/api/v1/orders

curl "https://api.ecomplataforma.com.br/api/v1/orders" -H "Authorization: Bearer sk_live_xxx"

200 OK

{
  "data": [ { "id": "o_501", "status": "paid", "totalCents": 15980 } ],
  "pagination": { "page": 1, "limit": 20, "total": 137 }
}

401Chave inválida

401 Chave inválida

{ "error": { "code": "UNAUTHORIZED", "message": "Chave de API ausente ou inválida." } }

403Sem escopo

403 Sem escopo

{ "error": { "code": "FORBIDDEN", "message": "A chave não possui o escopo necessário." } }