Anmeldung mit Schlüssel bei der API
Die API erkennt Ihre Firma am Schlüssel, den jede Abfrage mitschickt. Diese Seite erklärt, wie er mitgeht, was Test- und Live-Schlüssel unterscheidet und wann die API eine Abfrage ablehnt.
curl https://prisradar.ch/api/v1/usage \ -H "Authorization: Bearer $PRISRADAR_KEY"
{
"error": {
"code": "unauthorized",
"message": "Der Schlüssel fehlt, ist falsch oder gesperrt."
}
}Wie schicke ich den Schlüssel mit?
Im Header Authorization, als sogenanntes Bearer-Token: Authorization: Bearer pr_live_… Jede Abfrage ausser dem Status braucht ihn zwingend. Die Verbindung läuft immer über HTTPS, damit der Schlüssel unterwegs niemand mitlesen kann. Ohne Schlüssel oder mit einem falschen kommt der Fehler 401 unauthorized.
Das Verfahren ist ein Standard; die Beschreibung steht in RFC 6750.
Was unterscheidet Test- und Live-Schlüssel?
Testschlüssel beginnen mit pr_test_. Sie prüfen die Anfrage wie echt, auch Marke und Modell im Katalog, geben aber immer dieselben Beispielwerte mit test: true und kosten Sie nichts. Live-Schlüssel beginnen mit pr_live_, geben echte Marktwerte und zählen zum monatlichen Kontingent Ihres Pakets.
Wann lehnt die API einen Schlüssel ab?
Mit 401, wenn der Schlüssel fehlt, falsch oder gesperrt ist oder Ihr Zugang pausiert ist. Mit 403, wenn der Schlüssel auf bestimmte Server-Adressen beschränkt ist und die Abfrage von einer anderen kommt. In beiden Fällen nennt error.message den Grund in einem deutschen Satz.
Schlüssel erstellen, beschränken und sperren Sie in der Konsole.
Nicht gefunden, was Sie suchen?Schreiben Sie an info@prisradar.ch oder über das Kontaktformular.