Paginering, filters en synchroniseren

Lijsten doorbladeren met een cursor, filteren en sorteren, en wijzigingen synchroniseren.

Lijsten#

Een lijstantwoord heeft data (de objecten) en meta (de paginering):

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

Doorbladeren met een cursor#

Vraag de volgende pagina op met de next_cursor uit het vorige antwoord:

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

Is next_cursor gelijk aan null, dan ben je op de laatste pagina. Een cursor wijst naar een positie in de sortering, niet naar een paginanummer: records die er tussendoor bijkomen, verschuiven niets. Sorteer je op updated_at, dan kan een record dat tijdens het bladeren wordt gewijzigd verderop nog een keer langskomen; ontdubbel daarom op id. Een cursor hoort bij één sortering: gebruik hem niet met een andere sort. limit loopt van 1 tot 100; de standaard is 50.

Filteren en zoeken#

Filters staan in filter[...], bijvoorbeeld filter[status]=lead of filter[email]=jan@example.com. Met q zoek je in meerdere velden tegelijk. Welke filters er zijn, staat per endpoint in de API-referentie. Een onbekend filter geeft een validatiefout.

Sorteren#

sort=created_at sorteert oplopend, sort=-created_at aflopend. Aflopend op aanmaakdatum is de standaard.

Synchroniseren#

Wil je je eigen systeem bijhouden, haal dan periodiek op wat er gewijzigd is:

1. Onthoud het tijdstip van je vorige synchronisatie.
2. Vraag filter[updated_since]=<dat tijdstip>&sort=updated_at op en blader alle pagina's door.
3. Sla het nieuwe tijdstip op.

Laatst bijgewerkt op 15 september 2026