남은 사용 한도 가져오기
API 버전 2026-10-affable-towhee
get https://api.getlingara.com/v1/usage
계정에 적용되는 각 사용 한도를 사용량과 초기화 시점과 함께 나열합니다.
스코프 usage:read
매개변수
Lingara-Versionheaderstring선택- 이 요청에 응답할 API 버전입니다. 지정하지 않으면 액세스 토큰은 해당 클라이언트에 고정된 버전을, 토큰이 없는 요청은 현재 버전을 받습니다. 개발 중인 버전은 여기에서 지정해야만 사용할 수 있습니다. 알 수 없는 버전에는 코드
api_version_unknown과 함께400으로 응답합니다.GET /v1/versions에서 버전 목록을 확인할 수 있습니다.
응답
200 사용 한도
allowancearray of AllowanceRow필수featurestring필수windowstring필수limitinteger필수usedinteger필수remaininginteger필수reset_atinteger | null선택
ledgerUsageLedger | null선택매월 1일 UTC 자정 이후 이 클라이언트의 호출 수와 단위 수입니다. 사용량 기반 과금 클라이언트에만 포함되며, 그 호출은 사용 한도를 소모하지 않습니다. 최근 호출보다 최대 5초 늦게 반영될 수 있습니다.
sincestring필수callsinteger필수unitsinteger필수
오류
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필수
예시
번역본과 영어 참조 문서의 내용이 다른 경우, 영어 참조 문서가 올바른 것으로 봅니다.