Fehler

Jeder Fehler ist JSON mit dem HTTP-Status, seinem Namen, einer Meldung für Menschen und einem Link auf diese Seite:

{
  "status": 404,
  "error": "Not Found",
  "message": "Item 77 not found",
  "docsUrl": "https://pricana.io/docs/errors#not-found"
}

Bei Limits (402, 429) steht zusätzlich da, welches Limit greift, welchen Wert es in Ihrem Plan hat und wo Sie einen größeren Plan wählen:

{
  "status": 429,
  "error": "Too Many Requests",
  "message": "The monthly quota of 25,000 calls is used up; it starts over on 1 November",
  "limit": "apiCallsPerMonth",
  "allowed": 25000,
  "plan": "starter",
  "upgradeUrl": "https://pricana.io/pricing",
  "docsUrl": "https://pricana.io/docs/errors#apiCallsPerMonth"
}

Richten Sie Ihren Code nach status und limit; der Wortlaut von message kann sich ändern.

#400 Bad Request

Ein Parameter ist ungültig: ein unbekanntes sort, ein fehlerhaftes Datum, format=xml … Die Meldung nennt ihn. Korrigieren Sie die Anfrage; sie zu wiederholen hilft nicht. Auch eine Methode, die ein Endpunkt nicht kennt (405, der Header Allow nennt die möglichen), und ein Accept-Header, der etwas anderes als JSON verlangt (406), führen hierher.

#401 Unauthorized

Kein API-Key, oder einer, der falsch, widerrufen oder im alten Format ist. Senden Sie ihn als Authorization: Bearer prc_live_…; prüfen Sie ihn im Portal unter API (Authentifizierung).

#402 Payment Required

Etwas, das Ihr Plan nicht enthält. limit sagt, was:

#Dataset nicht im Plan

Sie haben eines Ihrer Datasets über die Zahl hinaus abgefragt, die Ihr Plan enthält (oder, bei Free, irgendein eigenes Dataset: Free liest die Beispieldaten). Entfernen Sie eines im Portal oder wählen Sie einen größeren Plan.

#Change-Feed

/changes (und /changes/recent mit einem Key) gibt es in den bezahlten Plänen. In Free nutzen Sie /items?changedSince=.

#Zahlung überfällig

Eine Zahlung ist seit 30 Tagen überfällig, deshalb ist der Zugang zu den Daten gesperrt, bis sie bezahlt ist (AGB § 11). upgradeUrl zeigt auf die Seite Billing. Es wird nichts gelöscht; mit der Zahlung ist sofort alles wieder freigeschaltet.

#Webhooks

Webhooks gibt es ab dem Plan Pro oder als Zusatzprodukt.

#Nutzer

Die Plätze Ihres Plans sind belegt (offene Einladungen zählen mit): Entfernen Sie jemanden oder wählen Sie einen größeren Plan.

#403 Forbidden

Ihr Key oder Ihre Anmeldung ist gültig, darf das aber nicht: Das Firmenkonto ist nicht mehr aktiv, oder Sie haben sein Team verlassen.

#404 Not Found

Kein solches Item, Produkt oder Dataset unter denen, die Sie sehen können: Es kann in einem Dataset liegen, das Sie nicht haben, oder aus der Historie Ihres Plans herausgefallen sein. Ein Pfad, den die API nicht hat, antwortet ebenfalls mit 404: Vergleichen Sie ihn mit der API-Referenz.

#409 Conflict

Die Anfrage passt nicht zum aktuellen Stand (im Portal etwa ein Name, der schon vergeben ist, oder die Höchstzahl an Endpunkten). Die Meldung sagt, was.

#Bedingungen noch nicht akzeptiert

Wer im Portal angemeldet ist, muss als Nutzer Ihrer Firma den AGB, der Datenlizenz und der Nutzungsrichtlinie zustimmen, bevor er mit den Daten arbeitet. Das geht im Portal; API-Keys sind davon nicht betroffen.

#429 Too Many Requests

Zu viele Anfragen. Retry-After sagt, wie viele Sekunden Sie warten sollen. limit sagt, welches Limit greift:

#Anfragen pro Sekunde

Das Tempo Ihres Plans (RateLimit-Limit pro Sekunde). Verteilen Sie die Anfragen oder warten Sie Retry-After Sekunden; sofort erneut zu fragen schlägt weiter fehl. Holen Sie größere Seiten (size bis 500) oder nutzen Sie einen Export statt vieler kleiner Anfragen.

#Calls pro Monat

Die Calls Ihres Plans für den Monat sind aufgebraucht (X-Quota-Remaining: 0); sie beginnen am 1. neu (UTC). Bezahlte Pläne können weitere Calls stattdessen berechnen (Overage, siehe Limits).

#Exportzeilen pro Monat

Ihre Exportzeilen für den Monat sind aufgebraucht (Free und Testphase; bezahlte Pläne berechnen weitere Zeilen). Ein Export, der über das Übrige hinausginge, schlägt nicht fehl: Er endet am Limit und sagt das in X-Export-Truncated.

#5xx

Bei uns ist etwas schiefgegangen. Versuchen Sie es nach einer kurzen Pause erneut (mit wachsenden Pausen). Bleibt der Fehler bestehen, melden Sie sich (Support) mit Uhrzeit und Anfrage.

#502, 503, 504

Pricana ist kurz nicht erreichbar, etwa während eines Updates. Versuchen Sie es in ein paar Sekunden erneut.