Skip to main content
POST
請求対象ワークスペースの API と MCP で共有する月間呼び出し枠、残りの呼び出し回数、リセット時刻、リクエストのレート制限を取得します。

認証と権限

string
必須
このヘッダーに VoiceCheap API キーを指定してください。同じ API キーを Authorization: Bearer で送信することもできます。OAuth アクセストークンは MCP でのみ使用でき、この REST エンドポイントでは使用できません。
必要な権限: usage:read. 有効な有料サブスクリプションが必要です。権限によってチーム内のロール、リソースの所有権、メディアクレジット、プランの制限が変わることはありません。

パラメーター

空の JSON オブジェクトを送信してください。このアクションに入力フィールドはありません。
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

リクエスト例

例に記載されたリソース識別子とメディアキーを、ご自身のアカウントで返された値に置き換えてください。同じ変更操作を再試行する場合は、リクエスト識別子を変更しないでください。

レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 現在の UTC 暦月における、アクティブなワークスペースの API/MCP 共通呼び出し利用枠を返します。

結果フィールド

操作の注意事項

  • API と MCP は同じワークスペースの利用枠を消費します。月間呼び出し数が無制限でも、レート制限とメディアクレジットは適用されます。
  • usage_get 自体は月間呼び出しカウンターの対象外ですが、引き続き認証とレート制限が適用されます。

使用量

このステータスまたは使用量の確認操作は、月間 API/MCP 呼び出し枠を消費しません。認証、有料アクセス、所有権、レート制限は引き続き適用されます。

エラー