Waar je begint met de Zendesk-API

De API leest en schrijft vrijwel alles wat de interface ook doet. Twee getallen bepalen of je koppeling echt volume overleeft.

De API leest en schrijft vrijwel alles: tickets, gebruikers, organisaties, velden, inrichting. Alles wat de interface ook doet, en een paar dingen die zij niet doet. Twee getallen bepalen of je koppeling echt volume overleeft, en allebei hangen ze van je abonnement af.

Ken je rate limit voordat je iets schrijft

Ga je eroverheen, dan antwoordt de API met 429 Too Many Requests. De header Retry-After zegt hoeveel seconden je moet wachten, en X-Rate-Limit geeft de limiet van je account. Vang die 429 af en respecteer Retry-After: een koppeling die dit negeert werkt feilloos in de test en valt om op je drukste ochtend.

Gebruik cursorpaginering, geen offset

Offsetpaginering met per_page en page is begrensd op de eerste 100 pagina's en 10.000 resources, een grens die geldt sinds 15 augustus 2023. Alles wat daaroverheen kan groeien, moet cursorpaginering gebruiken.

Cursorpaginering werkt met page[size] en page[after], waarbij de meeste endpoints hooguit 100 records per pagina toestaan. Blijf opvragen tot meta[has_more] false is. Bij offset stop je zodra next_page null is.

Gebruik een serviceaccount

Niet de persoonlijke inloggegevens van iemand. Vertrekt die persoon en wordt zijn account uitgezet, dan stopt elke koppeling die hem gebruikt, meestal op de dag van vertrek. Dat breekt de koppeling, en met een eigen account voorkom je het volledig.

Geef hem ook de smalste rol die werkt. Een koppeling die tickets leest heeft geen admin nodig, en hem inperken betekent dat een fout of een gelekt token niet verder reikt dan het werk vraagt.

Probeer eerst echt de inrichting

Triggers, webhooks en velden dekken veel. Code moet worden onderhouden door iemand die haar begrijpt, en die persoon wisselt vroeg of laat van baan.

Bouw je toch, test dan in een sandbox en niet tegen live tickets, en log aan jouw kant wat de koppeling doet. Verandert er onverwacht iets aan tickets, dan onderscheid je met dat logboek een mens van een koppeling.

Schrijf op wat hij doet

Wat hij aanraakt, waarom hij bestaat, wie hem beheert, welk account hij gebruikt en hoe hij met de rate limit omgaat. Die notitie maakt hem onderhoudbaar, en het is precies wat niemand opschrijft.

Zie ook

• Zendesk uitbreiden: de mogelijkheden op een rij
• Wanneer je een app nodig hebt en wanneer een webhook genoeg is
• Wat een sandbox is en waar hij voor is