SHOHS Cloud Console へようこそ
API や OAuth クライアントはプロジェクト単位で管理します。まずはプロジェクトを作成して、使いたい API を有効にしましょう。
ダッシュボード
プロジェクト情報
プロジェクト名
プロジェクト名
プロジェクト ID
project-id-000000
作成日
0000-00-00
所有者
owner
はじめに
有効な API とサービス
| 名前 | サービス名 | 有効にした日 | 有効なトークン |
|---|
API ライブラリ
指標
AI API の利用状況 —
1分あたり(直近60秒)
—
1日あたり
—
1時間ごとのリクエスト数(直近24時間)
| API キー | プロジェクト | 直近1分 | 今日(リセット後) |
|---|
リクエスト数 成功エラー(4xx / 5xx)
エンドポイント別
| メソッド / パス | リクエスト | エラー | 平均 (ms) |
|---|
認証情報別
| 名前 | リクエスト | エラー |
|---|
レスポンスコード別
最近のエラー
| 時刻 | リクエスト | コード | 認証情報 |
|---|
ライブラリ › API
API
認証情報
OAuth 2.0 クライアント ID 0
| 名前 | 作成日 | タイプ | クライアント ID | 操作 |
|---|
API キー 0
| 名前 | キー | 許可した機能 | 直近24時間 | 操作 |
|---|
OAuth 同意画面
プロジェクト共通のアプリ名です。ログイン画面には、各クライアントの「名前」(認証情報で付けた名前)が表示されます。
ログインの認可画面に表示されるロゴです。PNG / JPEG / WebP / GIF、1MB まで。正方形の画像がおすすめです。
同意について問い合わせるためのメールアドレスです。
アプリのドメイン
デベロッパーの連絡先情報
スコープ
| スコープ | API | 種別 | 説明 |
|---|
ドキュメント
設定の流れ
- プロジェクトを作成 — 画面上部のプロジェクト名から作成・切り替えできます。
- API を有効にする — 「ライブラリ」で使いたい API(例:Runtera API)を開き、「有効にする」を押します。
- OAuth 同意画面を構成 — アプリ名・サポートメールなどを登録します。
- データアクセス(スコープ)を追加 — 同意画面の「データアクセス」で、有効にした API のスコープを選びます。
- OAuth クライアント ID を作成 — 「認証情報」でリダイレクト URI を登録し、Client ID / Secret を受け取ります。
- アプリから認可リクエストを送り、受け取ったアクセストークンで API を呼び出します。
認可リクエスト
https://auth.shohs.net/auth/oauth2/authorize.php?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&state=RANDOM&scope=openid+profile+email
トークン交換
POST https://auth.shohs.net/auth/oauth2/token.php Content-Type: application/x-www-form-urlencoded grant_type=authorization_code&code=AUTH_CODE&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&redirect_uri=YOUR_REDIRECT_URI
アクセストークンは1時間有効です。grant_type=refresh_token で更新できます(リフレッシュトークンは30日)。
セキュリティ
- Client Secret はブラウザへ保存したり、Git へコミットしたりしないでください。
- 本番環境では HTTPS を使用し、
stateを必ず検証してください。 - 必要最小限のスコープだけを要求してください。
詳細 全エンドポイントとコード例は 開発者ドキュメント を参照してください。
管理:AI API の利用上限
管理者 ユーザー(アカウント)ごとの AI API の上限を設定します。上限はそのユーザーのすべての API キーの合計に適用されます。行を設定していないユーザーは標準値です。
1日の上限をリセットする時刻
| ユーザー | キー | 直近1分 / 今日 | 1分あたり | 1日あたり |
|---|
プロジェクト設定
プロジェクト ID は作成後に変更できません。
プロジェクトをシャットダウン
プロジェクト内のすべての OAuth クライアント・有効な API・同意画面の設定と、発行済みトークンが完全に削除されます。元に戻せません。