BroadNet
Referência·/error-codes

Referência do código de erro.

Cada código de erro devolvido pela API BroadNet, o seu significado e como lidar com ele. Atualizado sempre que novos códigos forem adicionados.

Navegável·Atualizado em setembro de 2026·Secção 10 de 15Centro de desenvolvedores

Overview

A API REST BroadNet reporta erros com um código de status HTTP padrão e um corpo JSON chamado ExceptionResponse, com cinco campos: status, error, message, errorCode e requestUri. A correspondência deve ser feita primeiro com base no status HTTP e, em seguida, no errorCode. Uma exceção: um token Bearer ausente ou inválido é rejeitado anteriormente, no gateway API, com um código 401 cujo corpo contém apenas error e message.

Códigos de status

O código 400 significa um erro de validação ou um campo obrigatório ausente: corrija a solicitação. O código 401 significa que o token Bearer está ausente ou é inválido, e o código 403 significa que não é permitido chamar a operação: corrija o token. O código 500 indica um erro inesperado do servidor e o código 502 significa que um fornecedor upstream rejeitou a chamada: tente novamente com um intervalo de espera exponencial. As vinculações SMPP devolvem códigos command_status SMPP padrão.

Exemplos

Copie, cole e substitua os marcadores — estes exemplos chamam a API de produção tal como estão.

ExceptionResponsejson
{
  "status": 400,
  "error": "Bad Request",
  "message": "…",
  "errorCode": "…",
  "requestUri": "/sms/sendSms"
}
401 Unauthorized (API gateway)json
{
  "error": "Unauthorized",
  "message": "Missing Authorization token"
}
Acesso de teste · resposta no prazo de um dia útil

Solicite acesso para testes e desenvolva com confiança.

Responderemos em até um dia útil com as credenciais de teste. Em seguida, instale o SDK TypeScript ou aceda à API REST de qualquer linguagem e envie a sua primeira mensagem de teste para o seu próprio número.

$npm install @broadnet/cpaas-sdk axiosready