Rate Limits

Sofia API zählt Anfragen in drei Fenstern: 15 Minuten, 24 Stunden und 30 Tage.

Token	15 Minuten	24 Stunden	30 Tage
Persönlicher Schlüssel (pro Konto)	150	1.000	10.000
OAuth-Client	100	500	15.000
OAuth-Client, pro autorisierter Person (bis zu 1.000)	+10	+25	+100

Header

Jede Antwort sagt Ihnen im IETF-Format, was noch übrig ist:

http

RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000

r ist die Zahl der verbleibenden Anfragen, t die Sekunden bis zum Zurücksetzen des Fensters, q das Kontingent und w das Fenster in Sekunden.

Wenn ein Fenster voll ist

Die Antwort ist 429 rate_limit_exceeded, mit einem Header Retry-After und dem erschöpften Fenster in details. Warten Sie so lange, bevor Sie es erneut versuchen.

Die API effizient nutzen

Registrieren Sie einen Webhook, statt einen Beitrag per Polling abzufragen.
Nutzen Sie limit bis 100, um Listen in weniger Seiten zu lesen.
Cachen Sie, was sich selten ändert: Plattformen, Betriebe, verbundene Konten.