Motimate: Gibt es irgendwelche Einschränkungen bei der Nutzung der öffentlichen API?

Satzgrenze

Die API arbeitet mit einem Ratenlimit von 1200 Anfragen pro 10 Minuten. Das bedeutet, dass du innerhalb eines Zeitraums von 10 Minuten maximal 2 Anfragen pro Sekunde senden kannst. Beachte, dass dieses Limit für alle unsere Endpunkte gilt und nicht auf einzelne Endpunkte angerechnet wird.

Wenn du dieses Limit überschreitest, erhältst du die Antwort 429 "Zu viele Anfragen ".

Der aktuelle Status des Ratenlimits ist in der Kopfzeile RateLimit verfügbar.

Beispiel:

RateLimit: limit=1200, remaining=956, reset=543

Siehe IETF-Entwurf für weitere Details.

Solltest du ein Problem damit haben, dieses Limit zu erreichen, führe bitte eine Latenzzeit zwischen den Anfragen ein, um wieder unter das Limit zu kommen.

Filter / Pfadargumente

Es gibt eine Grenze von 50 Argumenten (d.h. Benutzer-IDs) pro Aufruf, wenn du mit den Pfadargumenten filterst.

Paginierung

Die maximale Anzahl an Ergebnissen pro Seite beträgt 50. Verwende die Abfrageparameter page und per_page, um zusätzliche Ergebnisse zu erhalten.

 

Beispiel:

/users?page=3&per_page=30

Wie kann ich alle Daten von einer API mit Paginierungsbeschränkungen abrufen?
Hinweis: Dieses Beispiel verwendet GET /groups, aber du kannst die Schritte auch mit anderen Endpunkten wiederholen.

1.  

   1. Hole alle Daten:

      for i in {1..NUMBER_OF_PAGES}; do
      
          curl -X GET "https://motimateapp.com/public_api/groups?page=$i"
      
          done

   2. Speichere die Daten auf deinem Rechner.
       

   3. Hol nur Ressourcen, die nach dem letzten Fetch (z.B. vor einem Tag) aktualisiert oder erstellt wurden, und füge sie mit den Daten zusammen, die du bereits hast:

      
        curl -X GET "https://motimateapp.com/public_api/groups?filter[created_at_gt]=<ONE_DAY_AGO>"
      
        curl -X GET "https://motimateapp.com/public_api/groups?filter[updated_at_gt]=<ONE_DAY_AGO>"
      
        

   4. Immer wenn du eine DELETE-Anforderung durchführst, entfernst du die Ressource aus deiner Kopie.
       
   5. Führe regelmäßig (z.B. wöchentlich) einen Resync durch, indem du alle Daten erneut abrufst und deine Kopie aktualisierst.