Paginierung, Filter und Synchronisieren

Listen mit einem Cursor durchblättern, filtern und sortieren und Änderungen synchron halten.

Listen#

Eine Listenantwort hat data (die Objekte) und meta (die Paginierung):

{
  "data": [],
  "meta": {
    "limit": 50,
    "next_cursor": "eyJpZCI6IjlkM2Y2YzFlIn0",
    "prev_cursor": null
  }
}

Blättern mit einem Cursor#

Rufen Sie die nächste Seite mit dem next_cursor aus der vorherigen Antwort ab:

curl "https://app.klantly.com/api/v1/customers?limit=100&cursor=eyJpZCI6IjlkM2Y2YzFlIn0" \
  -H "Authorization: Bearer $KLANTLY_API_KEY"

Ist next_cursor gleich null, sind Sie auf der letzten Seite. Ein Cursor zeigt auf eine Position in der Sortierung, nicht auf eine Seitenzahl: Datensätze, die zwischendurch hinzukommen, verschieben nichts. Sortieren Sie nach updated_at, kann ein Datensatz, der sich während des Blätterns ändert, weiter hinten noch einmal erscheinen; entfernen Sie Duplikate daher anhand der id. Ein Cursor gehört zu einer Sortierung: Verwenden Sie ihn nicht mit einem anderen sort. limit reicht von 1 bis 100; Standard ist 50.

Filtern und Suchen#

Filter stehen in filter[...], zum Beispiel filter[status]=lead oder filter[email]=jan@example.com. Mit q durchsuchen Sie mehrere Felder gleichzeitig. Welche Filter es gibt, steht pro Endpunkt in der API-Referenz. Ein unbekannter Filter ergibt einen Validierungsfehler.

Sortieren#

sort=created_at sortiert aufsteigend, sort=-created_at absteigend. Absteigend nach Erstellungsdatum ist der Standard.

Synchronisieren#

Um Ihr eigenes System aktuell zu halten, rufen Sie regelmäßig ab, was sich geändert hat:

1. Merken Sie sich den Zeitpunkt Ihrer vorherigen Synchronisierung.
2. Rufen Sie filter[updated_since]=<dieser Zeitpunkt>&sort=updated_at ab und blättern Sie alle Seiten durch.
3. Speichern Sie den neuen Zeitpunkt.

Zuletzt aktualisiert am 15. September 2026