Stromposition

Stream-Positionselemente enthalten eine Positionsreferenz für einen oder mehrere logische Streams von zeitsequenzierten Daten. Die Positionsreferenz kann eine ungefähre externe Spezifikation wie ein Zeitstempel oder eine undurchsichtige interne Spezifikation der Position sein, die von einem vorherigen API-Aufruf zurückgegeben wird. Stream-Positionen können als komplexer, mehrelementarer Typ definiert sein oder eine Zeichenfolge sein.

Die Stream-Position wird verwendet, um Daten in Batches abzurufen, und ermöglicht es dem Aufrufer, durch das Ergebnis zu paginieren. Die innerhalb einer API-Anfrage übergebene Stream-Position ist der Wert der Stream-Position, die in der vorherigen Antwort zurückgegeben wurde. Das Ändern der Stream-Position, die vom vorherigen API-Aufruf zurückgegeben wurde, wird nicht empfohlen und kann zu unerwartetem API-Verhalten führen.

APIs zur Unterstützung der Stream-Position

Einfache Stream-Position

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

komplexe Fließposition

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