Posizione flusso

Gli elementi di posizione del flusso contengono un riferimento di posizione per uno o più flussi logici di dati in sequenza temporale. Il riferimento di posizione può essere una specifica esterna approssimativa come una marca temporale o una specifica interna opaca di posizione restituita da una chiamata API precedente. Le posizioni di flusso possono essere definite come un tipo complesso a più elementi o come una stringa.

La posizione del flusso viene utilizzata per recuperare i dati in batch e consente al chiamante di impaginare il risultato. La posizione del flusso passata all’interno di una richiesta API è il valore della posizione del flusso restituita nella risposta precedente. La modifica della posizione del flusso restituita dalla chiamata API precedente non è consigliata e potrebbe causare un comportamento API imprevisto.

API che supportano la posizione del flusso

Posizione semplice flusso

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

Posizione flusso complesso

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