Motimate : Y a-t-il des limites à l'utilisation de l'API publique ?

Limite du taux

L'API fonctionne avec une limite de 1200 requêtes par 10 minutes. Cela signifie que vous pouvez envoyer au maximum 2 demandes par seconde au cours d'une période de 10 minutes. Notez que cette limite est partagée par l'ensemble de nos points d'accès, plutôt que d'être comptabilisée pour des points d'accès individuels.

Si vous dépassez cette limite, vous recevrez une réponse 429 Too Many Requests.

L'état actuel de la limite de taux est disponible dans l'en-tête RateLimit.

Exemple :

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

Voir Projet de l'IETF pour plus de détails.

Si vous avez des difficultés à atteindre cette limite, veuillez introduire une période de latence entre les demandes afin de repasser en dessous de la limite.

Filtres / Arguments de chemin d'accès

Le nombre d'arguments (c'est-à-dire d'ID d'utilisateur) par appel est limité à 50 lorsque le filtrage est effectué à l'aide des arguments de chemin d'accès.

Pagination

Le nombre maximum de résultats par page est de 50. Utilisez les paramètres de requête page et par page pour obtenir des résultats supplémentaires.

 

Exemple :

/users?page=3&per_page=30

Comment récupérer toutes les données d'une API avec des limites de pagination ?
Note : Cet exemple utilise GET /groups, mais vous pouvez répéter les étapes avec d'autres points de terminaison.

1.  

   1. Récupérer toutes les données :

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

   2. Stockez les données sur votre machine.
       

   3. Ne récupère que les ressources qui ont été mises à jour ou créées après la dernière récupération (par exemple, il y a un jour) et les fusionne avec les données dont vous disposez déjà :

      
        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. Chaque fois que vous effectuez une requête DELETE, vous supprimez la ressource de votre copie.
       
   5. Périodiquement (par exemple une fois par semaine), effectuez une resynchronisation en récupérant toutes les données et en mettant à jour votre copie.