Stream-Position

Stream-Positionselemente enthalten eine Positionsreferenz für einen oder mehrere logische Streams von Daten mit einer Sequenzierung. Die Positionsreferenz kann eine ungefähre externe Spezifikation wie ein Zeitstempel oder eine undurchsichtige interne Positionsspezifikation sein, die von einem vorherigen API-Aufruf zurückgegeben wird. Streampositionen können als komplexer Typ mit mehreren Elementen oder als Zeichenfolge definiert werden.

Die Stream-Position wird zum Abrufen von Daten in Stapeln verwendet und ermöglicht es dem Aufrufer, durch das Ergebnis zu paginieren. Die in einer API-Anfrage übergebene Stream-Position ist der Wert der Stream-Position, die in der vorherigen Antwort zurückgegeben wurde. Eine Änderung der Stream-Position, die vom vorherigen API-Aufruf zurückgegeben wird, wird nicht empfohlen und kann zu einem unerwarteten API-Verhalten führen.

APIs, die die Streamposition unterstützen

Einfache Streamposition

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

Komplexe Stream-Position

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