API PúblicaErros

Serviço externo indisponível (502)

Um serviço de terceiros de que a operação depende falhou ou não respondeu.

Status: 502 Bad Gateway · type: https://api.nobur.com.br/errors/bad-gateway

Quando acontece

A operação depende de um serviço de fora da Nobur, como a consulta de CEP ou de CNPJ, a assinatura eletrônica ou o envio pelo WhatsApp, e esse serviço falhou ou não respondeu a tempo.

Tente de novo após alguns segundos, com intervalos crescentes entre as tentativas; a falha costuma ser passageira. Em POST e PUT, reenvie a mesma Idempotency-Key. Se persistir, fale com o suporte informando o request_id.

Exemplo

{
  "type": "https://api.nobur.com.br/errors/bad-gateway",
  "title": "External Service Error",
  "status": 502,
  "detail": "address lookup service unavailable",
  "instance": "/api/v1/address/lookup/01310100",
  "code": "bad_gateway.service_unavailable",
  "request_id": "req_abc123",
  "timestamp": "2026-02-15T12:00:00Z",
  "documentation_url": "https://docs.nobur.com.br/docs/api/erros/bad-gateway"
}

Erro interno (500)

Uma falha inesperada da Nobur impediu a operação.

Webhooks

Receba notificações em tempo real sobre eventos na plataforma Nobur.

Nesta página

Quando acontece O que fazer Exemplo