# Authentifiez-vous auprès de l'API BroadNet

> Chaque requête REST porte un en-tête Authorization: Bearer contenant le jeton d'accès de votre compte BroadNet. Un jeton absent ou invalide renvoie 401 avec un corps d'erreur JSON. L'API HTTP historique (/websmpp) reçoit les identifiants en paramètres et n'est conservée que pour les intégrations existantes de l'ère SMPP.

- URL canonique: https://www.broadnet.me/fr/developers/authentication
- Langue: fr
- Dernière mise à jour: 2026-10-21
- Éditeur: BroadNet (https://www.broadnet.me)

Chaque requête adressée à l'API REST BroadNet contient votre jeton d'accès dans un en-tête Authorization: Bearer. Ce jeton est émis par compte et provient de votre compte BroadNet; l'API ne propose aucun échange de nom d'utilisateur et de mot de passe contre un jeton. Un jeton manquant ou invalide est rejeté par la passerelle API avec HTTP 401 et un corps JSON de deux champs, error et message.

> **N’intégrez jamais le jeton côté client.** Le jeton d'accès vous autorise à envoyer des requêtes sur votre compte. Conservez-le dans une variable d'environnement ou un gestionnaire de secrets, hors du système de contrôle de version, des applications mobiles et du code du navigateur, et appelez toujours l'API via HTTPS.

## Identifiants /websmpp hérités

L'ancienne API HTTP sous /websmpp, conservée pour les intégrations de l'ère SMPP, utilise les identifiants (nom d'utilisateur et mot de passe, ou clé d'accès) comme paramètres de requête au lieu d'un jeton Bearer. Utilisez-la uniquement si vous en dépendez déjà; les nouvelles intégrations doivent utiliser l'API REST avec jeton Bearer.

## Exemples

### 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" }'
```

Même en-tête sur chaque point de terminaison et chaque canal.

### 401 Unauthorized

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

## Voir aussi

- [Norme d'authentification et de signature des API](https://www.broadnet.me/fr/reference/api-authentication-and-signing)
- [Démarrage rapide](https://www.broadnet.me/fr/developers/quickstart)
