Paginierung

Listen-Endpunkte der API geben Daten seitenweise zurück. Auf der Plattform haben sich historisch zwei Paginierungsschemas etabliert; das jeweilige Schema ist beim Endpunkt in der interaktiven Referenz angegeben.

Schema 1 — Offset und X-Total-Count

Klassische Offset-basierte Paginierung. Die Anfrage akzeptiert Query-Parameter limit (Seitengröße) und offset (wie viele Einträge übersprungen werden):

curl -H "Authorization: Bearer mbp_IHR_TOKEN" "https://ihre-domain/api/bots/BOT_ID/subscribers?limit=50&offset=100"

Die Gesamtzahl der Einträge wird im Antwort-Header X-Total-Count zurückgegeben. Daraus ergibt sich die Seitenzahl: Blättern Sie, indem Sie offset um limit erhöhen, solange offset kleiner als der Wert von X-Total-Count ist. Der Antwort-Body ist ein Array der Elemente der aktuellen Seite.

Schema 2 — Cursor before und has_more

Cursor-basierte Paginierung für zeitlich geordnete Feeds (z. B. Dialog-Nachrichten). Die Anfrage akzeptiert limit und den optionalen Cursor before — Bezeichner oder Markierung des letzten bereits empfangenen Elements:

curl -H "Authorization: Bearer mbp_IHR_TOKEN" "https://ihre-domain/api/bots/BOT_ID/users/USER_ID/dialog?limit=50&before=CURSOR"

Die Antwort enthält eine Seite mit Elementen und das Flag has_more. Solange has_more gleich true ist, wiederholen Sie die Anfrage und übergeben Sie im Parameter before den Cursor des zuletzt empfangenen Elements. Wenn has_more false wird, ist es die letzte Seite.

Welches Schema verwenden

Sie wählen kein Schema — es wird vom Endpunkt vorgegeben. Listen-/Nachschlage-Endpunkte verwenden in der Regel Offset und X-Total-Count; zeitlich geordnete Feeds verwenden den Cursor before und has_more. Prüfen Sie stets die Endpunkt-Seite in der Referenz.

Nächste Schritte