API-limieten en wat er gebeurt als je eroverheen gaat

Zendesk begrenst hoeveel API-aanroepen je per minuut mag doen. Eroverheen gaan mislukt niet luidruchtig, en dat is het probleem.

Zendesk begrenst hoeveel API-aanroepen je per minuut mag doen. Eroverheen gaan mislukt niet luidruchtig, en dat is het probleem.

Hoe de limiet werkt

De Help Center-API deelt dat tegoed en heeft geen eigen limiet. Ga je eroverheen, dan antwoordt de API met 429 Too Many Requests. Er komen twee headers mee: Retry-After zegt hoeveel seconden je moet wachten, en X-Rate-Limit geeft de limiet van je account.

Een goed geschreven integratie wacht het interval uit Retry-After af en probeert het opnieuw. Een slecht geschreven integratie behandelt de 429 als een fout, of erger: probeert het meteen opnieuw en maakt het erger.

Wat je tegoed verbruikt

Meer bronnen dan het woord "integratie" doet vermoeden.

• Je eigen integraties.
• Apps uit de Marketplace, waarvan sommige spraakzaam zijn.
• Rapportagegereedschap dat gegevens ophaalt.
• Scripts voor migraties en bulkbewerkingen.

Die delen één tegoed. Een migratiescript op volle snelheid kan de app uithongeren waar je agents op leunen, en dat voel je meteen in de werkruimte.

Houd het in de gaten

Zendesk toont je API-verbruik, en het is een blik waard voordat je aanneemt dat een integratie stuk is. Een patroon waarbij het verbruik elke dag op hetzelfde moment piekt, wijst meestal op een geplande taak die gratis vertraagd kan worden.

Verbruik verlagen

• Gebruik bulkeindpunten in plaats van één aanroep per record.
• Gebruik incrementele exports in plaats van alles opnieuw op te halen.
• Spreid geplande taken zodat er geen drie op dezelfde minuut lopen.
• Bewaar tussentijds wat niet vaak verandert.

Hem verhogen

In sommige gevallen mogelijk, en pas het vragen waard nadat je hebt gekeken wat het huidige tegoed opsoupeert. De meeste accounts die tegen de limiet aanlopen hebben één slecht opgevoede verbruiker in plaats van een echte behoefte aan meer.

Zie ook

• Je API-verbruik in de gaten houden
• Kan ik mijn API-snelheidslimiet verhogen
• Kan ik de API-limiet raken door gewoon gebruik van de interface