Autenticazione

Dovrai autenticare le API per accedere a qualsiasi endpoint delle API di ParceLabs.
In questa guida vedremo come funziona l'autenticazione.

ParceLabs offre due metodi per autenticare le API: Chiave API via URL e Chiave API via Header (consigliato).
Le chiavi API che vengono fornite sono differenziate tra produzione e sviluppo, e possono essere vincolate a ruoli/scope e allowlist IP/domini per ridurre i rischi di sicurezza.

In questa modalità la chiave API è incorporata direttamente nell'URL della richiesta (es. https://api.parcelabs.com/v2/endpoint/{API_KEY}). È documentata perché esiste e resta supportata per compatibilità della versione 1.x delle API, ma non dovrebbe essere la scelta predefinita: per le nuove integrazioni è fortemente consigliato l'uso della Chiave API via header per evitare di esporre la chiave nei log/URL.

POST
https://api.parcelabs.com/v2/endpoint/{API_KEY}
Caricamento...

Per favore non salvare la tua chiave API di ParceLabs su GitHub!


Il modo consigliato per autenticarsi con le API di ParceLabs è usare la chiave API negli header.
Le chiavi vengono fornite per ambiente (produzione e sviluppo), con ruoli/scope già configurati e allowlist IP/domini per limitarne l'uso inappropriato. Puoi inviarla come Authorization: Bearer {API_KEY} (consigliato) oppure come X-API-Key: {API_KEY}. Alcune integrazioni possono includere anche una firma HMAC SHA-256 nell'header del tipo X-Signature per verificare l'origine del payload. Ecco come aggiungere il token alla richiesta:

In questo esempio puoi vedere come utilizzare l'header Authorization: Bearer {API_KEY}

Authorization: Bearer sk_live_abc123def456
Content-Type: application/json

In questo esempio puoi vedere come utilizzare l'header X-API-Key: {API_KEY}

X-API-Key: sk_live_abc123def456
Content-Type: application/json

Mantieni sempre il tuo token al sicuro e reimpostalo se sospetti che sia stato compromesso.

Was this page helpful?