Het eventsdocument ophalen

API-versie 2026-10-affable-towhee

get https://api.getlingara.com/v1/asyncapi.json

Geeft het AsyncAPI-document terug dat de events van Lingara beschrijft, voor de API-versie waaronder het verzoek wordt beantwoord: de versie die in Lingara-Version staat, of anders de huidige versie. Er is geen token nodig.

Bevoegdheden Geen authenticatie vereist

Parameters

Lingara-Versionheaderstringoptioneel: De API-versie waaronder dit verzoek wordt beantwoord. Zonder deze krijgt een toegangstoken de versie waaraan zijn client is gekoppeld, en een verzoek zonder token de huidige versie. De versie die nog in ontwikkeling is, bereik je alleen door die hier te noemen. Een onbekende versie geeft 400 met code api_version_unknown. GET /v1/versions toont de versies.

Antwoorden

200 Het AsyncAPI-document

Fouten

410application/json: De API-versie waaronder dit verzoek wordt beantwoord, is stopgezet. Stuur een ondersteunde versie mee in Lingara-Version, of koppel de client aan een andere versie.
4XXapplication/json: Het verzoek is geweigerd. code geeft de reden aan en error beschrijft die in woorden.
503application/json · text/plain: De dienst is tijdelijk niet beschikbaar; probeer het opnieuw na het aantal seconden in Retry-After. Tijdens onderhoud is de body platte tekst in plaats van de foutenvelop.

codestringverplicht: Waarom het verzoek is geweigerd, als stabiele code om op te vertakken: bijvoorbeeld insufficient_scope (403), rate_limited (429) en, voor een client met verbruiksafrekening, spend_cap_reached (402) en metered_billing_inactive (402).
errorstringverplicht

Voorbeeld

curl "https://api.getlingara.com/v1/asyncapi.json"

Liever een bibliotheek? Zie de sectie Bibliotheken.

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