Einführung in die REST-API
Aus Planfix
API-Zugriff ist nur für kostenpflichtige oder Premium-Konten verfügbar.
Um mit der Arbeit zu beginnen, erzeugen Sie ein Autorisierungstoken. Dies kann der Hauptadministrator des Kontos im Bereich: Kontoverwaltung — API-Zugriff — REST API tun.
Zugriff auf die Schnittstelle
- Der Zugriff auf die Schnittstelle erfolgt über den Einstiegspunkt, dessen Adresse im Abschnitt REST API verfügbar ist:
- https://your_account_name.planfix.сom/rest/
- Es gibt außerdem einen Link zur REST-Spezifikation und einen Sandbox-Bereich zum Debuggen von Anfragen an Ihr Konto.
- Anfragen, die von der API-Spezifikationsseite gesendet werden, werden direkt in Ihrem Konto ausgeführt, nicht an Testdaten.
Bitte beachten
Der Zugriff auf die Schnittstelle erfolgt über das HTTPS-Protokoll. Alle Anfragen über eine unsichere Verbindung werden automatisch ignoriert. Wir empfehlen, vor dem Senden von Daten eine sichere Testverbindung mit dem Planfix-Schnittstellen-Zugangspunkt einzurichten.
Beschränkungen für Anfragen von Anwendungen
- Alle Konten haben je nach bezahltem Paket folgende Limits:
- 20.000 / 50.000 / 100.000 Anfragen pro Tag
- 1 Anfrage pro Sekunde
- Für Methoden, die Listen von Werten zurückgeben, ist ein Limit von 100 Ergebnissen pro Anfrage gesetzt.
- Die ungefähre Anzahl der verbleibenden Anfragen pro Tag wird im Header X-RateLimit-Remaining zurückgegeben — der Wert wird ungefähr alle 10 Minuten aktualisiert.