Stroompositie

De elementen van de stroompositie bevatten een positieverwijzing voor één of meerdere logische stromen van tijd geordende gegevens. De positieverwijzing kan een benaderende externe specificatie zoals een timestamp, of een ondoorzichtige interne specificatie van positie zijn die door een vorige API vraag is teruggekeerd. Stroomposities kunnen worden gedefinieerd als een complex type met meerdere elementen of kunnen een tekenreeks zijn.

De stroompositie wordt gebruikt om gegevens in partijen terug te winnen, en staat de bezoeker toe om door het resultaat te pagineren. De streampositie die binnen een API-aanvraag wordt doorgegeven, is de waarde van de streampositie die in de vorige reactie is geretourneerd. Het wordt niet aanbevolen de streampositie te wijzigen die door de vorige API-aanroep is geretourneerd, en dit kan leiden tot onverwacht API-gedrag.

API's die de stroompositie ondersteunen

Eenvoudige streampositie

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

Complexe streampositie

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