De parameter gebruiken

Voeg updated_within_days toe als queryparameter aan je verzoek:

GET /v1/contacts?updated_within_days=7

Dit geeft alleen contacten terug waarvan de gegevens in de afgelopen 7 dagen zijn gewijzigd. Het venster is glijdend vanaf het moment van de aanvraag, dus 1 staat gelijk aan de afgelopen 24 uur.

Geldige waarden zijn gehele getallen van 1 tot en met 365. Laat je de parameter weg, dan werkt de endpoint precies zoals voorheen en worden alle contacten teruggegeven.

De volledige parameterbeschrijving vind je in de OpenAPI-specificatie via GET /v1/openapi.json.

Betrouwbaarheid van `updated_at`

Vanaf deze release wordt de updated_at-timestamp op een contact alleen bijgewerkt als er daadwerkelijk iets aan de contactgegevens verandert. Eerder werd dit veld ook aangepast tijdens de nachtelijke importrun, ook als er niets gewijzigd was.

Let op: de timestamp is nog niet volledig betrouwbaar in alle situaties. Uitschrijvingen en wijzigingen in lijstlidmaatschap worden momenteel nog niet meegenomen in updated_at. Contacten die alleen zijn uitgeschreven of aan een lijst zijn toegevoegd, kunnen dus buiten je resultaten vallen als je filtert op updated_within_days.

Veelgestelde vragen

Waarden als 0 of meer dan 365 vallen buiten het geldige bereik. Raadpleeg de OpenAPI-spec (GET /v1/openapi.json) voor de exacte foutrespons die de API in dat geval teruggeeft.

Als een contact alleen is uitgeschreven en verder niet gewijzigd, wordt updated_at daar nog niet op bijgewerkt. Dat contact verschijnt dan niet in de resultaten van updated_within_days, ook al heeft er een relevante wijziging plaatsgevonden. Dit geldt ook voor wijzigingen in lijstlidmaatschap.

De parameter is gedocumenteerd in de OpenAPI-specificatie van Xendy. Je bereikt die via GET /v1/openapi.json.

Joeri Ras

Geschreven door

Joeri Ras

Oprichter & mede-eigenaar @ Xendy

Liever direct contact?

Gerelateerde artikelen