ecentic API 認証。
公開ディスカバリーには認証情報は一切不要です。マーチャントアカウントの読み取りや変更を行う場合のみ、自分で発行したbearerキーが必要です。営業連絡や手動プロビジョニングはありません。
セルフサービスキー · Bearerトークン · OAuthメタデータ
リクエストパスを選択
まずはAPIを確認してください。クライアントがマーチャントアカウントに対して操作を行う場合は Bearer key を追加します。
クライアント
認証情報は不要
Discovery + Sandbox
キー不要なもの
ディスカバリーは意図的に公開されています。
/api/v1配下のすべてのエンドポイントはAuthorizationヘッダーなしで利用できます。well-knownディスカバリードキュメント、OpenAPIドキュメント、MCPのlist_plansツールも同様です。エージェントは、アカウント作成前でもAPI全体 — エンドポイント、プラン、プロトコル、スキル、レート制限、エラーコード — を把握できます。
サンドボックスも公開されています。POST /api/v1/sandbox/simulationは、合成スコアリングから計算された実際のシミュレーションと同一形式のレスポンスを返すため、認証情報なしでクライアントを開発・テストできます。
クライアント
Bearer key が必要
REST + MCP
キーの送信
どこでも同じヘッダーです。
保護されたすべてのリクエストで、キーをbearerトークンとして送信してください。同じヘッダーがRESTインターフェースとMCPツール呼び出しの両方で利用できます。
キーをクエリ文字列に含めないでください。クエリ文字列はログ、プロキシ、リファラーヘッダーに残るため、ecenticはそこからキーを読み取りません。
キーを発行する
どちらも自身で管理できる、2つのセルフサービス方法があります。
- アカウントを作成
- キーを発行
- キーを一度だけ保存
アカウントを作成し、ダッシュボードまたは認証済みセッションからcreate_api_key MCPツールを呼び出してキーを発行してください。キーはecentic_sk_…形式で、長期利用可能です。一度だけ表示され、ecentic側ではハッシュのみ保存するため、紛失時は復旧ではなく再発行となります。
ローテーションは新しいキーを発行し、古いキーを無効化して行います。どの工程でも人への連絡は不要です。
失敗時
401は次に進む先を示します。
- HTTP 401認証情報が不足しているか無効です
- RFC 9728保護されたリソースメタデータ
- RFC 8414認可サーバーメタデータ
認証情報が欠落している、または無効な場合は、Protected Resource Metadataドキュメント(RFC 9728)を示すWWW-Authenticateヘッダー付きHTTP 401が返されます。そこを辿ると認可サーバーメタデータ(RFC 8414)に到達するため、401に遭遇したクライアントは人がドキュメントを読むことなく認証方法を発見できます。
RESTインターフェースでは本文はcode: "unauthenticated"を含むRFC 9457のエラードキュメントです。MCPエンドポイントでは、コード-32001とerror.data内のresource_metadataヒントを持つJSON-RPCエラーになります。