버전

API 버전 2026-10-affable-towhee

Lingara API는 yyyy-mm-adjective-noun 형식의 이름으로 버전을 구분합니다. 모든 경로의 /v1은 바뀌지 않으며, 호출이 무엇을 받고 무엇을 반환할지는 버전이 정합니다.

클라이언트의 버전

클라이언트는 만들 당시의 현재 버전에 고정되며, 그 액세스 토큰으로 버전 헤더 없이 한 호출은 그 버전으로 응답받습니다. 클라이언트 소유자는 연동 페이지(app.getlingara.com/admin)에서 지원되는 다른 버전으로 다시 고정할 수 있으며, 액세스 토큰은 다음 교환부터 새 버전을 사용합니다.

한 번의 호출에만 쓰는 버전

호출에 Lingara-Version: <id>를 보내면 고정된 버전 대신 그 버전을 사용하며, 응답에는 사용된 버전이 표시됩니다. 개발 버전은 이 방법으로만 사용할 수 있고 예고 없이 바뀔 수 있습니다.

버전의 수명 주기

고정할 수 있는 버전은 supported이고, 더 오래 유지되는 버전은 lts입니다. deprecated 버전은 모든 응답에 Deprecation 및 Sunset 헤더를 붙여 계속 응답하며, 지원 중단 예정이 된 지 최소 90일이 지나야 종료됩니다. discontinued 버전은 410과 코드 api_version_discontinued로 거부됩니다.

공개된 버전

번역본과 영어 참조 문서의 내용이 다른 경우, 영어 참조 문서가 올바른 것으로 봅니다.