Zum Hauptinhalt springen

Begrenzte Nutzung der REST-API

tado° avatar
Verfasst von tado°
Vor über 2 Wochen aktualisiert

Um langfristig Stabilität zu gewährleisten und dennoch den Zugriff auf unsere REST-API zu ermöglichen, haben wir die folgenden Begrenzungen eingeführt:

  • 100 Anfragen / Tag

    Dies reicht immer noch aus für grundlegende Anwendungsfälle, die nicht über die lokalen APIs von tado° verfügbar sind: HomeKit für V3/V3+-Geräte oder Matter für tado° X-Geräte.

  • Für Auto-Assist- oder AI-Assist-Abonnenten: 20.000 Anfragen / Tag

    Dies deckt auch anspruchsvollere Anwendungsfälle ab. Mit den Abonnementgebühren können wir die höheren Kosten ausgleichen, die durch zusätzliche Serveraufrufe entstehen.

Wenn Sie in letzter Zeit Schwierigkeiten hatten, liegt das vermutlich daran, dass das Tageslimit von 20.000 bzw. 100 Anfragen für Ihr Konto erreicht wurde. Um zu sehen, wie viele Anfragen Ihnen noch zur Verfügung stehen, können Sie den Header „ratelimit“ überprüfen. Dieser erscheint wie folgt:

  • ratelimit: "perday";r=123 bedeutet, dass Ihnen noch 123 Anfragen verbleiben („r=“ zeigt die Anzahl der verbleibenden Anfragen an).

oder

  • ratelimit: "perday";r=0;t=123 bedeutet, dass Ihr Limit erreicht ist („r=0” bedeutet, dass keine Anfragen mehr verbleiben) und sich Ihr Limit nach 123 Sekunden wieder auffüllt („t=“ zeigt die Anzahl der Sekunden bis zur Erneuerung des Limits an).

Obwohl wir unsere REST-API nie offiziell unterstützt haben, war sie in der Vergangenheit für Dritte immer frei und unbegrenzt zugänglich.

Wir glauben an eine faire Nutzung und möchten dieses Prinzip auch weiterhin unterstützen.

Mit dieser Begrenzung weichen wir von unserem Grundsatz leicht ab, da wir festgestellt haben, dass ein kleiner Teil besonders aktiver API-Nutzer einen unverhältnismäßig hohen Anteil unserer Serverkosten verursacht.

Hat dies deine Frage beantwortet?