ログイン

Guides / Authentication

認証とAPIキー

すべてのリクエストは API キーで認証します。アカウントは申請制で発行し、キーはアカウントでログインして開発者コンソールからご自身で作成します。プランと上限はキーではなくアカウントに設定されます。

キーの種類

API キーの種類
キー利用先発行条件アカウントあたりの有効なキー
ck_live_…Data API https://api.chickstockfi.com/openapi/v1Data API プラン(PoC · Launch · Business · Scale · Enterprise)が適用されたアカウント有料等級 3個 · PoC 2個
ck_pers_…PRO API https://api.chickstockfi.com/openapi/pro/v1 と MCP サーバーPRO プラン(Data · Ask · Bundle)が適用されたアカウント2個
ck_mcp_at_…MCP サーバーAI ツールが OAuth で接続したときに自動で発行されます(アクセストークン1時間、リフレッシュトークン30日)。ご自身で作成するものではありません。接続20件

リクエストヘッダー

キーは次のいずれかのヘッダーで送ります。両方を送った場合は X-API-Key が使われます。クエリ文字列でのキー指定には対応していません。

サムスン電子 · 005930

http
GET /openapi/v1/news?symbol=005930 HTTP/1.1
Host: api.chickstockfi.com
Authorization: Bearer ck_live_xxxxxxxxxxxxxxxx

# または
X-API-Key: ck_live_xxxxxxxxxxxxxxxx

キーのスコープ

2つの API のキーは相互に利用できません。

  • Data API キー(ck_live_)で PRO API を呼び出すと、401 WRONG_KEY_SCOPE が返ります。ただし MCP サーバーには Data API キーで接続でき、Data API ツールが使えます(MCP 接続)。
  • PRO API キー(ck_pers_)で Data API を呼び出すと、401 UNAUTHORIZED が返ります。
  • 存在しないキーや失効したキーは、どちらの API でも 401 INVALID_KEY になります。

アカウントとプラン

  • アカウントは利用申請を審査したうえで発行します。セルフサインアップはありません。発行されたアカウント ID とパスワードで開発者コンソールにログインしてください。
  • PoC は基本7日間のトライアルです(期間はご相談のうえ調整できます)。目標等級(Launch・Business・Scale)のトライアル上限ですべてのエンドポイントをご利用いただけます。目標等級を決めない場合は Launch です。期間が終了するとアカウントのすべてのキーが 403 POC_ENDED で停止し、期間の延長または正式契約のあと、同じキーで再びご利用いただけます。
  • 有料等級(Launch・Business・Scale・Enterprise)と PRO プランは、契約内容を確認したうえでアカウントに適用します。適用後は、作成済みのキーにもすぐに反映されます。
  • 1日の呼び出し上限はアカウント単位のため、同じアカウントのキーで共有します。Data API の1分あたりの上限はキーごとにカウントします。詳しくはレート制限とクォータをご覧ください。

キーの保管

  • キーの値全体は、発行時に一度だけ表示されます。サーバーには SHA-256 ハッシュのみを保存するため、紛失した場合は再表示できません。新しいキーを発行してください。
  • キーはサーバー側でのみ使用してください。ブラウザのコード、モバイルアプリのバンドル、公開リポジトリには含めないでください。ck_live_ · ck_pers_ のプレフィックスで漏えい検出ルールを設定しておくことをおすすめします。
  • ログやお問い合わせメールには、キー全体ではなくコンソールに表示される先頭部分(例: ck_live_8fA2c1…)のみを記載してください。

ローテーションと失効

コンソールのローテーションは、同じ名前・スコープで新しいキーを作成し、以前のキーをその場で失効させます。以前のキーで送ったリクエストには、すぐに 401 INVALID_KEY が返ります。

サービスを止めずにキーを切り替えるには、有効なキーの上限の範囲で次の手順を行ってください。

  1. コンソールで新しいキーを作成します(有効なキーは有料等級 3個、PoC 2個、PRO API 2個まで)。
  2. 新しいキーでデプロイし、リクエストが正常に処理されることを確認します。
  3. 以前のキーを失効させます。失効したキーは元に戻せません。

キーが漏えいした可能性がある場合

コンソールで該当するキーをすぐにローテーションするか、失効させてください。不審な呼び出しが疑われる場合は、日時とキーの先頭部分を help@alpsoft.io までお知らせください。

MCP 接続の OAuth

Claude・ChatGPT などの AI ツールは、キーの代わりに OAuth 2.1 で MCP サーバーに接続できます。スコープは mcp のみで、利用できるツールはアカウントの PRO プランによって決まります。 手順はMCP 接続にまとめています。