Strömposition

Strömpositionselement innehåller en positionsreferens för en eller flera logiska strömmar med tidssekvensdata. Positionsreferensen kan vara en ungefärlig extern specifikation, som en tidsstämpel, eller en ogenomskinlig intern specifikation av positionen som returnerats av ett tidigare API-anrop. Strömpositioner kan definieras som komplexa, flerelementstyper eller vara en sträng.

Strömpositionen används för att hämta data i batchar och gör att anroparen kan paginera genom resultatet. Strömpositionen som skickas i en API-begäran är värdet för strömpositionen som returnerades i det föregående svaret. Det rekommenderas inte att strömpositionen som returneras från det tidigare API-anropet ändras, vilket kan leda till oväntat API-beteende.

API:er som stöder strömposition

Enkel strömposition

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

Komplex strömposition

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