Autenticazione con chiave presso l’API
L’API riconosce la Sua azienda dalla chiave che ogni richiesta invia. Questa pagina spiega come la si invia, cosa distingue le chiavi di test da quelle live e quando l’API rifiuta una richiesta.
curl https://prisradar.ch/api/v1/usage \ -H "Authorization: Bearer $PRISRADAR_KEY"
{
"error": {
"code": "unauthorized",
"message": "Der Schlüssel fehlt, ist falsch oder gesperrt."
}
}Come invio la chiave?
Nell’header Authorization, come cosiddetto bearer token: Authorization: Bearer pr_live_… Ogni richiesta, tranne lo stato, ne ha assolutamente bisogno. La connessione passa sempre per HTTPS, così nessuno può leggere la chiave lungo il percorso. Senza chiave o con una chiave sbagliata arriva l’errore 401 unauthorized.
La procedura è uno standard; la descrizione si trova in RFC 6750.
Cosa distingue le chiavi di test da quelle live?
Le chiavi di test iniziano con pr_test_. Verificano la richiesta come se fosse reale, anche marca e modello nel catalogo, ma restituiscono sempre gli stessi valori d’esempio con test: true e non Le costano nulla. Le chiavi live iniziano con pr_live_, restituiscono valori di mercato reali e contano nel contingente mensile del Suo pacchetto.
Quando l’API rifiuta una chiave?
Con 401, se la chiave manca, è sbagliata o revocata, oppure se il Suo accesso è sospeso. Con 403, se la chiave è limitata a determinati indirizzi di server e la richiesta arriva da un altro. In entrambi i casi error.message indica il motivo con una frase in tedesco.
Le chiavi le crea, le limita e le revoca nella console.
Non ha trovato ciò che cerca?Scriva a info@prisradar.ch o tramite il modulo di contatto.