GETAPI pública v1

Pedido por id (pública)

Retorna um pedido pelo id para integradores. Escopo orders:read.

GET/api/v1/orders/{id}
AutenticaçãoChave de APIorders:read.

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

Parâmetros de caminho

  • iduuidobrigatório

    Identificador do pedido.

Cabeçalhos

  • Authorizationstringobrigatório

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

Requisição

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

Resposta200

200 OK
{ "data": { "id": "o_501", "status": "paid", "totalCents": 15980 } }

Respostas de erro

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." } }
404Não encontrado
404 Não encontrado
{ "error": { "code": "NOT_FOUND", "message": "Recurso não encontrado." } }