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órioIdentificador do pedido.
Cabeçalhos
AuthorizationstringobrigatórioChave 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." } }