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: truesignifica que a mesma requisição pode ser enviada de novo mais tarde.- Registre em log
codeecorrelationId(nunca a chave) e informe ocorrelationIdquando 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 |