Versionen

API-Version 2026-10-affable-towhee

Die Lingara-API wird über Namen versioniert, in der Form yyyy-mm-adjective-noun. Das /v1 in jedem Pfad ändert sich nie: Die Version bestimmt, was ein Aufruf annimmt und zurückgibt.

Die Version deines Clients

Ein Client ist an die Version gebunden, die bei seiner Erstellung aktuell war, und ein Aufruf mit einem seiner Zugriffstokens ohne Versions-Header wird in dieser Version beantwortet. Wem der Client gehört, kann ihn auf der Seite Integrationen unter app.getlingara.com/admin an eine andere unterstützte Version binden; seine Zugriffstokens verwenden die neue Version ab ihrem nächsten Austausch.

Eine Version für einen Aufruf

Sende Lingara-Version: <id> mit einem Aufruf, um statt der gebundenen Version diese zu verwenden; die Antwort nennt die verwendete Version. Die Entwicklungsversion ist nur auf diese Weise erreichbar und kann sich ohne Ankündigung ändern.

Wie eine Version altert

Eine Version, an die du binden kannst, ist supported, und eine länger gepflegte ist lts. Eine deprecated Version antwortet weiterhin, mit den Headern Deprecation und Sunset in jeder Antwort, und endet frühestens 90 Tage nach ihrer Abkündigung. Eine discontinued Version wird mit 410 und dem Code api_version_discontinued abgelehnt.

Veröffentlichte Versionen

Weichen eine Übersetzung und die englische Referenz voneinander ab, ist die englische Referenz maßgeblich.