API キーの使用量と有効期限をプログラムで照会
ダッシュボードで読み取り専用トークンを発行し、1 コマンドで全アクティブ API キーの有効期限・日次使用量・クォータを照会。自分のスクリプトやダッシュボード、アラートに簡単に組み込めます。
照会できる内容
1 つのトークンで API キーの主要な運用指標をカバー
有効期限
各アクティブ API キーの正確な有効期限。早めに更新を計画し、停止を回避できます。
日次・月次の使用量
本日の費用とリクエスト数、今月のクォータ使用量 / 上限と使用率がひと目で分かります。
トークンのセルフ管理
ダッシュボードでトークンを発行・リセット・失効。サーバーはハッシュのみ保存し、平文は一度だけ表示します。
3 ステップで統合
トークン発行からクエリ成功まで数分
ダッシュボードでトークンを発行
ログイン後「オープン API」を開き、生成をクリックすると qot_ で始まるトークンが得られます(大切に保管)。
トークンを付けて API を呼ぶ
Authorization: Bearer qot_... を付けて GET /api/v1/openapi/keys を呼ぶと使用量が JSON で返ります。
ツールに統合
レスポンスをスクリプト・監視ダッシュボード・期限アラート・CI に流して運用を自動化。
1 コマンドで開始
標準 HTTP + Bearer トークン。どの言語からでも呼べます
各アクティブキーの名前・有効期限・本日の使用量・月次クォータを含む構造化 JSON を返し、そのまま解析できます。
- •読み取り専用:自分のアカウントの API キーのみ照会でき、作成・変更・残高消費はできません。
- •キャッシュとレート制限を内蔵し、高速かつ上流に優しい設計です。
# リクエスト
curl -H "Authorization: Bearer qot_xxx" \
https://qcode.cc/api/v1/openapi/keys
レスポンス例
{
"ok": true,
"data": {
"keys": [{
"name": "Pro unlimited/day",
"is_active": true,
"expires_at_display": "2026/08/22 21:35",
"current_daily_cost": 42.04,
"current_requests": 115,
"monthly_cost_used": 8837.56,
"monthly_cost_limit": 13000.0
}],
"active_api_keys": 1
}
}
エンドポイント一覧
すべて読み取り専用 GET、認証は Bearer トークンで統一
| エンドポイント | 説明 |
|---|---|
| GET /api/v1/openapi/keys | 全アクティブ API キーの有効期限・本日の使用量・月次クォータ・使用率を一覧。 |
| GET /api/v1/openapi/me | アカウント単位のサマリー:アクティブキー数と本日の合計費用。 |
| GET /api/v1/openapi | セルフ説明:エンドポイント一覧と使い方を返し、死活確認に便利。 |
代表的なユースケース
使用量データを既存のワークフローに接続
期限アラート
定期的に有効期限を確認し、期限前にメール / IM / Telegram で更新を自動通知。
使用量ダッシュボード
日次費用とクォータ使用率を Grafana や表計算、自作パネルに取り込み。
複数キーの巡回監視
チームが複数キーを持つ場合、すべてのキーの状態とクォータを一括取得。
CI / 自動化
高価な AI ジョブの前に、パイプラインでキーの有効性とクォータを検証。
セキュリティ設計
トークンは高エントロピーのランダム文字列で、サーバーは HMAC ハッシュのみ保存し平文は一度だけ表示。厳格な読み取り専用でキーの作成・管理や残高操作は不可、分単位 / 日単位のレート制限を内蔵。漏洩時はダッシュボードでワンクリック再発行すれば旧トークンは即無効になります。
よくある質問
アクセストークンの取得方法は?
QCode にログインし、ダッシュボードの「オープン API」カードで生成をクリック。平文トークンは一度だけ表示されるのですぐにコピーを。紛失時はいつでも再発行できます。
このトークンは安全ですか?
安全です。読み取り専用で、自分のアカウントの API キーの使用量と期限のみ照会でき、キーの作成 / 変更や残高消費はできません。サーバーはハッシュのみ保存し、漏洩時はワンクリック再発行で無効化されます。
呼び出し回数の制限はありますか?
あります。トークンごとに分単位・日単位の上限があり、結果は数秒キャッシュされるため通常のポーリングや監視には十分です。より高いクォータが必要な場合はサポートへご連絡を。