Lingara API 참조 문서

API 버전 2026-10-affable-towhee

Lingara가 가르치는 언어로 어휘 목록과 수업 계획을 생성하고, 튜터와 대화할 수 있습니다. 각 호출의 비용은 그 호출을 하는 클라이언트가 부담합니다. allowance 클라이언트는 소유자의 사용 한도를 소모하고, metered 클라이언트는 사용량에 따라 요금이 청구됩니다.

라이브러리가 더 편하신가요? 라이브러리 섹션을 보세요.

기본 URL https://api.getlingara.com

Authorization: Bearer <token> 형식으로 보내는 OAuth 2.0 액세스 토큰입니다. 자기 자신으로 동작하는 서버는 토큰 URL에서 클라이언트의 ID와 시크릿을 교환합니다(client_credentials). 동의한 Lingara 사용자를 대신해 동작하는 앱은 인가 코드(authorization_code)를 사용한 뒤 갱신합니다. 토큰은 1시간 동안 유효합니다. 각 작업에는 하나의 스코프가 필요합니다.

토큰 URL https://api.getlingara.com/oauth/token

스코프
`vocab:generate`	어휘 목록을 생성합니다.	어휘 목록 생성
`lesson_plans:read`	내 수업 계획을 읽고 진행 상황에 다시 연결합니다.	수업 계획 가져오기 수업 계획에 다시 연결
`lesson_plans:write`	수업 계획을 만듭니다.	수업 계획 만들기
`tutor:converse`	튜터와 대화합니다. 유료 요금제가 필요합니다.	튜터에게 한 턴 보내기
`usage:read`	남은 사용 한도 또는 `metered` 클라이언트의 이번 달 사용량을 확인합니다.	남은 사용 한도 가져오기
`events:read`	내 계정에 관한 이벤트를 읽고, 이벤트를 받을 엔드포인트를 등록합니다.	이벤트 목록 이벤트 스트리밍
`events:write`	게임이나 연동에서 Lingara로 이벤트를 보냅니다.	이벤트 보내기

오류

402application/json: 사용량 기반 과금 클라이언트의 호출이 아무것도 소모하기 전에 거부되었습니다. spend_cap_reached: 클라이언트 또는 그 계정이 월 지출 한도에 도달했습니다. 연동 페이지에서 한도를 올리세요. metered_billing_inactive: 이 계정에서 사용량 기반 과금이 활성화되어 있지 않습니다. 연동 페이지에서 설정하거나 결제 수단을 업데이트하세요.
410application/json: 이 요청에 응답하는 API 버전은 지원이 종료되었습니다. Lingara-Version에 지원되는 버전을 보내거나 클라이언트를 다른 버전에 다시 고정하세요.
4XXapplication/json: 요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.
503application/json · text/plain: 서비스를 일시적으로 사용할 수 없습니다. Retry-After에 있는 초만큼 기다린 후 다시 시도하세요. 점검 중에는 본문이 오류 엔벨로프가 아닌 일반 텍스트입니다.
5XXapplication/json: 요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.

codestring필수: 요청이 거부된 이유를 분기에 쓸 수 있는 안정적인 코드로 나타냅니다. 예: insufficient_scope(403), rate_limited(429), 사용량 기반 과금 클라이언트의 경우 spend_cap_reached(402)와 metered_billing_inactive(402).
errorstring필수