Prisradar
Endpunkte

Nutzung und Status der API abfragen

Zwei kleine Abfragen helfen Ihrer Software, sich selbst zu überwachen: Nutzung zeigt, wie viel vom Monat verbraucht ist, Status, ob die API gerade antwortet. Beide zählen nicht zum Kontingent.

Aktualisiert am 15.10.2026Prisradar Team

Auf dieser Seite
curl https://prisradar.ch/api/v1/usage \
  -H "Authorization: Bearer $PRISRADAR_KEY"
Antwort 200 · /usage
{
  "period": {
    "start": "2026-09-30T22:00:00.000Z",
    "end": "2026-10-31T23:00:00.000Z"
  },
  "plan": "Partner",
  "quota": 2000,
  "used": 1231,
  "remaining": 769,
  "requests": 1284,
  "errors": 5
}
Antwort 200 · /status
{
  "status": "ok",
  "version": "v1",
  "time": "2026-10-14T11:45:49.172Z"
}

Wie sehe ich, wie viel vom Kontingent bleibt?

Mit GET /v1/usage. Die Antwort nennt den laufenden Monat, Ihr Paket, das Kontingent, wie viele Bewertungen schon zählen und wie viele bleiben, dazu alle Abfragen und Fehler. Der Monat beginnt am Ersten um Mitternacht Schweizer Zeit. Dieselben Zahlen zeigt die Konsole unter «Nutzung».

GEThttps://prisradar.ch/api/v1/usage

Ja. Jede Antwort der API nennt im Header X-RateLimit-Remaining, wie viele Abfragen in dieser Minute noch gehen, und mit einem Live-Schlüssel X-Quota-Remaining, wie viele Bewertungen im Monat bleiben. So weiss Ihre Software nach jeder Bewertung Bescheid, ohne zusätzlich zu fragen.

Wie prüfe ich, ob die API antwortet?

Mit GET /v1/status, ohne Schlüssel. status ist ok, wenn alles läuft. paused heisst: Prisradar hat die API kurz angehalten, jede andere Abfrage bekommt dann 503. Die Antwort nennt dazu die Version und die Uhrzeit. Fragen Sie den Status am besten in Ihrer Überwachung ab, nicht vor jeder Bewertung.

GEThttps://prisradar.ch/api/v1/status

Nicht gefunden, was Sie suchen?Schreiben Sie an info@prisradar.ch oder über das Kontaktformular.

Tippen Sie, wonach Sie suchen: eine Funktion, eine Frage oder einen Fehlercode.

↑ ↓ auswählen↵ öffnenEsc schliessen