コンテンツへスキップ

ecentic API 認証。

公開ディスカバリーには認証情報は一切不要です。マーチャントアカウントの読み取りや変更を行う場合のみ、自分で発行したbearerキーが必要です。営業連絡や手動プロビジョニングはありません。

セルフサービスキー · Bearerトークン · OAuthメタデータ

01

リクエストパスを選択

まずはAPIを確認してください。クライアントがマーチャントアカウントに対して操作を行う場合は Bearer key を追加します。

クライアント

認証情報は不要

Discovery + Sandbox

キー不要なもの

ディスカバリーは意図的に公開されています。

認証情報は不要

02

キーを発行する

どちらも自身で管理できる、2つのセルフサービス方法があります。

  1. アカウントを作成
  2. キーを発行
  3. キーを一度だけ保存

アカウントを作成し、ダッシュボードまたは認証済みセッションからcreate_api_key MCPツールを呼び出してキーを発行してください。キーはecentic_sk_…形式で、長期利用可能です。一度だけ表示され、ecentic側ではハッシュのみ保存するため、紛失時は復旧ではなく再発行となります。

ローテーションは新しいキーを発行し、古いキーを無効化して行います。どの工程でも人への連絡は不要です。

登録完全ガイド
03

失敗時

401は次に進む先を示します。

  1. HTTP 401認証情報が不足しているか無効です
  2. RFC 9728保護されたリソースメタデータ
  3. RFC 8414認可サーバーメタデータ
401

認証情報が欠落している、または無効な場合は、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エラーになります。

ecenticの評価に認証情報は不要です。必要なのはマーチャントアカウントに対して操作する場合のみです。