Referência
Erros
O envelope de erro, os códigos que existem e o que cada um pede que você faça.
Todas as páginas▾
Comece aqui
Inteligência artificial
Referência
Toda resposta de erro tem a mesma forma — inclusive as que nem chegaram ao seu endpoint, como JSON malformado:
{
"error": {
"code": "validation_error",
"message": "Corpo inválido.",
"issues": [
{ "path": "regularPriceCents", "message": "Required" }
]
}
}issues só aparece nos 422 e nomeia cada campo que falhou. É a sua superfície de depuração no dia a dia — em contraste deliberado com os 401, que são opacos de propósito e não dizem qual parte da credencial estava errada.
Todos os códigos
| HTTP | Código | Significado |
|---|---|---|
| 400 | invalid_json | O corpo não pôde ser lido como JSON (ou o Content-Type está errado). |
| 401 | missing_api_key | Faltou o cabeçalho Authorization: Bearer .... |
| 401 | invalid_api_key | Chave não reconhecida. |
| 401 | revoked_api_key | Chave revogada no painel. |
| 403 | store_inactive | A loja está desativada na zankh. |
| 403 | subscription_suspended | Assinatura suspensa por falta de pagamento — toda rota responde isso até a fatura ser paga. |
| 404 | product_not_found | Produto inexistente, ou de outra loja. |
| 404 | order_not_found | Pedido inexistente, ou de outra loja. |
| 404 | agent_order_not_found | Pedido do agente inexistente, ou de outro parceiro. |
| 409 | slug_taken | Já existe um produto com esse slug nesta loja. |
| 409 | email_in_use | Cadastro de loja: o e-mail do dono já tem conta. |
| 409 | slug_in_use | Cadastro de parceiro: o slug já existe. |
| 409 | order_already_paid | Cancelamento recusado — estorne pelo painel. |
| 409 | agent_order_already_accepted | Recusa negada: o pedido já tinha sido aceito. |
| 409 | agent_order_already_rejected | Aceite negado: o pedido já tinha sido recusado e o cliente estornado. |
| 422 | validation_error | Corpo ou query inválidos — veja issues. |
| 500 | internal_error | Erro inesperado do servidor. Não há nada errado com a sua requisição; tente de novo. |