Errori di autenticazione

Spiegazioni dettagliate e soluzioni per gli errori relativi all'autenticazione.

---

HTTP 401 Unauthorized

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

Lista di controllo:

Verifica	Atteso
Nome intestazione	Authorization (con A maiuscola)
Prefisso valore	Bearer (con spazio dopo Bearer)
Origine token	Campo token dalla risposta di /api/v1/login
Token non scaduto	Verificare expireAt via /api/v1/login-extended
Nessun carattere extra	Rimuovere spazi prima/dopo la stringa del token

---

HTTP 401 — Token scaduto

Soluzione: Effettuare nuovamente l'accesso:

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

Prevenzione — rinnovare proattivamente prima della scadenza:

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)

Causa: /api/v1/login-extended richiede un contesto di accesso automatico non configurato per il vostro account.

Soluzione: Usare /api/v1/login al suo posto, o contattare il referente DPD.

---

Credenziali corrette ma ancora 401?

1. Verificare di utilizzare l'URL di ambiente corretto
2. Verificare che il proprio account sia attivo — contattare il supporto DPD
3. Verificare se il proprio indirizzo IP deve essere autorizzato per l'accesso API