Position de la diffusion

Les éléments de position de diffusion contiennent une référence de position pour un ou plusieurs flux logiques de données séquencées dans le temps. La référence de position peut être une spécification externe approximative comme un horodatage ou une spécification interne opaque de position renvoyée par un précédent appel API. Les positions de diffusion peuvent être définies sous la forme d’un type complexe à plusieurs éléments ou d’une chaîne.

La position du flux est utilisée pour récupérer des données par lots et permet à l’appelant de paginer le résultat. La position du flux transmise dans une requête API est la valeur de la position du flux renvoyée dans la réponse précédente. La modification de la position du flux renvoyée par l’appel API précédent n’est pas recommandée et peut entraîner un comportement API inattendu.

API prenant en charge la position du flux

Position simple du flux

<streamPosition>8UJZetaMb1V6uUZl+L7DcPP2jG+PMmtpF</streamPosition>

Position complexe du flux

<startPosition>
  <latestCreatedAt  />
  <oldestCreatedAt>2013-08-01T00:13:13+00:00</oldestCreatedAt>
  <activityCreatedAt  />
  <offset>ID:1086173</offset>
</startPosition>