Erreurs d'authentification

Explications détaillées et solutions pour les erreurs liées à l'authentification.

---

HTTP 401 Unauthorized

{
  "status": 401,
  "error": "Unauthorized",
  "message": "JWT token is missing or invalid"
}

Liste de contrôle :

Vérification	Attendu
Nom de l'en-tête	Authorization (avec A majuscule)
Préfixe de la valeur	Bearer (avec un espace après Bearer)
Source du jeton	Champ token de la réponse de /api/v1/login
Jeton non expiré	Vérifier expireAt via /api/v1/login-extended
Pas de caractères supplémentaires	Supprimer les espaces avant/après le jeton

---

HTTP 401 — Jeton expiré

Solution: Se reconnecter :

curl -X POST "https://label-print-shipments.dpd.ch/api/v1/login" \
  -H "Content-Type: application/json" \
  -d '{"username": "votre_utilisateur", "password": "votre_mdp"}'

Prévention — renouveler proactivement avant expiration :

const tokenExpiry = new Date(loginResponse.expireAt);

async function getValidToken() {
  const fiveMinuteBuffer = 5 * 60 * 1000;
  if (Date.now() > tokenExpiry.getTime() - fiveMinuteBuffer) {
    await reAuthenticate();
  }
  return currentToken;
}

---

HTTP 403 — Forbidden (login-extended)

Cause: /api/v1/login-extended nécessite un contexte de connexion automatique non configuré pour votre compte.

Solution: Utilisez /api/v1/login à la place, ou contactez votre responsable de compte DPD.

---

Identifiants corrects mais toujours 401 ?

1. Vérifiez que vous utilisez la bonne URL d'environnement
2. Vérifiez que votre compte est actif — contactez le support DPD
3. Vérifiez si votre adresse IP doit être autorisée pour l'accès API