Pular para o conteúdo

Erros

Um erro é um status HTTP com um corpo JSON:

{ "code": "INVALID_INPUT", "messageKey": "…", "retryable": false, "correlationId": "…" }
  • code é estável: baseie sua lógica nele.
  • retryable: true significa que a mesma requisição pode ser enviada de novo mais tarde.
  • Registre em log code e correlationId (nunca a chave) e informe o correlationId quando escrever para o suporte.
Status Código Quando O que fazer
400 INVALID_INPUT Requisição ou campo incorreto, ou parâmetro desconhecido Corrija a requisição; não a repita como está
401 NOT_AUTHENTICATED Sem chave, chave errada ou chave substituída Pare e confira a chave
403 FORBIDDEN A conta da marca está banida na suly.gg Pare e fale com o suporte
404 NOT_FOUND Não há esse participante nesta oferta, ou o endereço é desconhecido Confira o id e o caminho
409 OFFER_ENDED A oferta está fechada: códigos e créditos não são mais aceitos Pare as rotinas; a leitura continua funcionando
409 PARTICIPANT_NOT_ACTIVE Crédito para um criador sem código ou recusado Envie um código primeiro
409 CREATOR_BANNED O criador está banido na suly.gg Não pague
409 INSUFFICIENT_BUDGET O orçamento é menor que o valor mais a taxa Adicione orçamento à oferta e depois repita
409 EXTERNAL_ID_CONFLICT Este externalId foi usado com outros dados Investigue; nunca sobrescreva
429 (limite de requisições) Requisições demais Repita mais tarde, com uma pausa
503 DEPENDENCY_UNAVAILABLE Um erro temporário Repita a mesma requisição mais tarde