Referência
Erros de API e códigos de erro
Erros usam códigos de status HTTP e sempre têm o mesmo corpo JSON. param nomeia o campo quando um campo é a causa. Cada resposta tem um cabeçalho X-Request-Id: cite-o em um ticket de suporte.
{
"error": {
"code": "text_too_long",
"message": "The text is longer than 10 segments (1,530 GSM-7 or 670 UCS-2 characters).",
"param": "text",
"doc_url": "https://bulksmsapi.cc/en/docs/errors#text_too_long"
}
}Códigos
| code | HTTP | Causa | Dinheiro |
|---|---|---|---|
| invalid_json | 400 | O corpo não é um objeto JSON, ou Content-Type não é application/json. | Corrija o corpo. Nada foi cobrado. |
| invalid_request | 400 | Um campo está faltando ou tem o tipo errado; o parâmetro o nomeia. | Corrija o campo. Nada foi cobrado. |
| invalid_number | 400 | Nenhum número na solicitação pôde ser lido como E.164 (+ e 7 a 15 dígitos). | Verifique os números. Nada foi cobrado. |
| unsupported_country | 400 / 404 | Nenhum país com preço corresponde aos números, ou GET /v1/pricing/{country} tem um código desconhecido. | Verifique a lista de países. Nada foi cobrado. |
| text_too_long | 400 | O texto precisa de mais de 10 segmentos. | Encurte o texto. Nada foi cobrado. |
| too_many_recipients | 400 | Mais de 10.000 destinatários em uma solicitação. | Divida a lista. Nada foi cobrado. |
| schedule_out_of_range | 400 | send_at não é um horário válido entre 2 minutos e 45 dias a partir de agora. | Escolha outro horário. Nada foi cobrado. |
| suppressed | 400 | Todos os números na solicitação estão na sua lista de não enviar (Configurações no console). | Nada foi enviado ou cobrado. |
| unauthorized | 401 | O cabeçalho Authorization está faltando, malformado ou a chave foi revogada. | Envie uma chave ativa. Nada foi cobrado. |
| top_up_required | 402 | O saldo é menor que o custo da solicitação; a mensagem informa ambos os valores. | Recarregue e envie novamente. Nada foi cobrado. |
| not_found | 404 | O id não existe nesta conta, ou o endpoint não existe. | Verifique o id e o caminho. |
| idempotency_conflict | 409 | A Idempotency-Key foi usada com um corpo de solicitação diferente nas últimas 24 horas. | Use uma nova chave para uma nova solicitação. |
| not_cancelable | 409 | Apenas um lote agendado pode ser cancelado; este já começou ou terminou. | Nada mudou. |
| rate_limited | 429 | A chave fez mais de 600 solicitações nos últimos 60 segundos. | Aguarde Retry-After segundos. Nada foi cobrado. |
| server_error | 500 | Algo falhou do nosso lado. | Tente novamente com a mesma Idempotency-Key. |
Tentando novamente
- Erros 4xx, exceto 429, exigem uma alteração na solicitação; enviar a mesma solicitação novamente resulta no mesmo erro.
- No caso de 429, aguarde o número de segundos indicado em Retry-After.
- No caso de 5xx ou timeout de rede, tente novamente com a mesma Idempotency-Key: se a primeira solicitação foi aceita, você recebe a resposta dela em vez de um segundo envio.