Prisradar
Principes

Authentification par clé auprès de l’API

L’API reconnaît votre entreprise à la clé que chaque requête transmet. Cette page explique comment la transmettre, ce qui distingue les clés de test et live, et quand l’API refuse une requête.

Mis à jour le 15.10.2026L’équipe Prisradar

Sur cette page
curl https://prisradar.ch/api/v1/usage \
  -H "Authorization: Bearer $PRISRADAR_KEY"
Réponse 401
{
  "error": {
    "code": "unauthorized",
    "message": "Der Schlüssel fehlt, ist falsch oder gesperrt."
  }
}

Dans l’en-tête Authorization, sous forme de jeton Bearer : Authorization: Bearer pr_live_… Toutes les requêtes sauf le statut en ont impérativement besoin. La connexion passe toujours par HTTPS, pour que personne ne puisse lire la clé en chemin. Sans clé ou avec une clé erronée, vous recevez l’erreur 401 unauthorized.

Ce procédé est un standard, décrit dans la RFC 6750.

Qu’est-ce qui distingue les clés de test et live ?

Les clés de test commencent par pr_test_. Elles vérifient la requête comme en réel, y compris la marque et le modèle dans le catalogue, mais donnent toujours les mêmes valeurs d’exemple avec test: true et ne vous coûtent rien. Les clés live commencent par pr_live_, donnent de vraies valeurs du marché et comptent dans le quota mensuel de votre forfait.

Quand l’API refuse-t-elle une clé ?

Avec 401 si la clé manque, est erronée ou révoquée, ou si votre accès est en pause. Avec 403 si la clé est limitée à certaines adresses de serveur et que la requête vient d’une autre. Dans les deux cas, error.message indique la raison dans une phrase en allemand.

Vous créez, limitez et révoquez les clés dans la console.

Vous n’avez pas trouvé ce que vous cherchez ?Écrivez à info@prisradar.ch ou via le formulaire de contact.

Tapez ce que vous cherchez : une fonction, une question ou un code d’erreur.

↑ ↓ sélectionner↵ ouvrirEsc fermer