残りの利用枠を取得
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任意月初日の UTC 午前 0 時以降の、このクライアントの呼び出し数とユニット数です。従量課金クライアントの場合にのみ含まれ、その呼び出しは利用枠を消費しません。最新の呼び出しから最大 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必須
例
翻訳と英語版リファレンスの内容が異なる場合は、英語版リファレンスが正しいものとします。