# Autentique-se com a API BroadNet

> Toda requisição REST leva um cabeçalho Authorization: Bearer com o token de acesso da sua conta BroadNet. Um token ausente ou inválido devolve 401 com um corpo de erro JSON. A API HTTP legada (/websmpp) recebe as credenciais como parâmetros e é mantida apenas para integrações existentes da era SMPP.

- URL canônico: https://www.broadnet.me/pt/developers/authentication
- Idioma: pt
- Última atualização: 2026-10-21
- Editor: BroadNet (https://www.broadnet.me)

Cada requisição à API REST BroadNet inclui o seu token de acesso no cabeçalho Authorization: Bearer. O token é emitido por conta e provém da sua conta BroadNet; a API não realiza nenhuma chamada que troque nome de utilizador e palavra-passe por um token. Um token ausente ou inválido é rejeitado no gateway API com HTTP 401 e um corpo JSON contendo dois campos: error e message.

> **Nunca incorpore o token no lado do cliente.** O token de acesso concede direitos de envio na sua conta. Mantenha-o numa variável de ambiente ou num gestor de segredos, fora do controlo de versão, aplicações móveis e código do navegador, e sempre chame a API por HTTPS.

## Credenciais legadas /websmpp

A API HTTP legada em /websmpp, mantida para integrações da era SMPP, aceita credenciais como parâmetros de requisição (utilizador e palavra-passe, ou chave de acesso) em vez de um token Bearer. Use-a somente se você já depende dela; novas integrações devem usar a API REST com token Bearer.

## Exemplos

### authenticated request

```bash
curl -X POST https://api.broadnet.me/sms/identify \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Hello from BroadNet" }'
```

O mesmo cabeçalho em todos os pontos de extremidade e em todos os canais.

### 401 Unauthorized

```json
{
  "error": "Unauthorized",
  "message": "Missing Authorization token"
}
```

## Relacionados

- [Padrão de autenticação e assinatura de API](https://www.broadnet.me/pt/reference/api-authentication-and-signing)
- [Início rápido](https://www.broadnet.me/pt/developers/quickstart)