Aller au contenu

API publique

Parcourir les résultats et rester dans les limites

Les listes se paginent par curseur et non par décalage : suivez donc le curseur que la réponse vous donne au lieu d’en calculer un. Surveillez les en-têtes de limite, et utilisez updatedSince pour interroger plutôt que tout relire.

Étapes

  1. Suivez le curseur de chaque réponse jusqu’à ce qu’il n’en revienne plus. Ne construisez pas de curseurs vous-même.
  2. Gardez une taille de page raisonnable — de grandes pages font moins de requêtes, mais plus lentes.
  3. Interrogez avec updatedSince plutôt que de parcourir toute la collection à intervalle régulier.
  4. Lisez les en-têtes de limite et ralentissez avant d’être refusé, pas après.
  5. Stockez le requestId de tout ce qui échoue, pour l’assistance.

Comment vérifier le résultat

Un parcours complet renvoie chaque objet une fois, et une interrogation répétée ne lit que ce qui a changé.

Ce qui coince le plus souvent

  • Construire des pages par décalage, qui dérivent quand les données changent en dessous.
  • Tout relire chaque minute et heurter la limite.
  • Réutiliser un curseur périmé et obtenir une erreur de curseur invalide.
Cela a-t-il réglé votre problème ?

Cela n’a pas aidé

Écrivez-nous en précisant la plateforme et la version, les étapes suivies, le résultat attendu et l’espace de travail ou le QR code concerné. Masquez tout secret avant de joindre quoi que ce soit.

Écrire à l’assistance