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

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

HTTPCódigoSignificado
400invalid_jsonO corpo não pôde ser lido como JSON (ou o Content-Type está errado).
401missing_api_keyFaltou o cabeçalho Authorization: Bearer ....
401invalid_api_keyChave não reconhecida.
401revoked_api_keyChave revogada no painel.
403store_inactiveA loja está desativada na zankh.
403subscription_suspendedAssinatura suspensa por falta de pagamento — toda rota responde isso até a fatura ser paga.
404product_not_foundProduto inexistente, ou de outra loja.
404order_not_foundPedido inexistente, ou de outra loja.
404agent_order_not_foundPedido do agente inexistente, ou de outro parceiro.
409slug_takenJá existe um produto com esse slug nesta loja.
409email_in_useCadastro de loja: o e-mail do dono já tem conta.
409slug_in_useCadastro de parceiro: o slug já existe.
409order_already_paidCancelamento recusado — estorne pelo painel.
409agent_order_already_acceptedRecusa negada: o pedido já tinha sido aceito.
409agent_order_already_rejectedAceite negado: o pedido já tinha sido recusado e o cliente estornado.
422validation_errorCorpo ou query inválidos — veja issues.
500internal_errorErro inesperado do servidor. Não há nada errado com a sua requisição; tente de novo.