Versies

API-versie 2026-10-affable-towhee

De Lingara-API heeft versies met een naam, in de vorm yyyy-mm-adjective-noun. De /v1 in elk pad verandert nooit: de versie bepaalt wat een aanroep accepteert en teruggeeft.

De versie van je client

Een client is vastgezet op de versie die actueel was toen hij werd aangemaakt, en een aanroep met een van zijn toegangstokens zonder versieheader wordt in die versie beantwoord. De eigenaar van de client kan hem op de pagina Integraties, op app.getlingara.com/admin, op een andere ondersteunde versie vastzetten; zijn toegangstokens gebruiken de nieuwe versie vanaf hun volgende inruil.

Een versie voor één aanroep

Stuur Lingara-Version: <id> mee met een aanroep om die versie te gebruiken in plaats van de vastgezette; het antwoord noemt de gebruikte versie. De ontwikkelversie is alleen zo bereikbaar en kan zonder aankondiging veranderen.

Hoe een versie veroudert

Een versie waarop je kunt vastzetten is supported, en een die langer wordt onderhouden is lts. Een deprecated versie antwoordt nog, met de headers Deprecation en Sunset bij elk antwoord, en stopt pas minstens 90 dagen nadat ze is uitgefaseerd. Een discontinued versie wordt geweigerd met 410 en de code api_version_discontinued.

Gepubliceerde versies

Als een vertaling afwijkt van de Engelse referentie, is de Engelse referentie juist.