ログイン無料トライアルを開始
easyCoexistence 公式 API

Partner API の認証:Bearer ec_live_ キー、ローテーション、401 エラー

Partner API のすべてのリクエストは、アカウントの秘密キーを Authorization: Bearer ec_live_… ヘッダーに含め、サーバーから送信します。easyCoexistence のアカウントごとにキーは1つあり、ダッシュボードの「Profile」「Developers」から作成するほか、AI アシスタントに create_api_key の実行を頼んでも作成できます。キーは一度だけ表示されます。ローテーションを行うと新しいキーが発行され、古いキーは直ちに無効になります。キーがない場合や誤っている場合は 401 unauthorized が返されます。

ec_live_

すべての Partner API キーの先頭に付く接頭辞。各リクエストでは Authorization: Bearer として送信します。

1 key

アカウントが同時に保持できるキーの数。このキーで作成されたすべての接続は、そのアカウントに属します。

401

キーがない場合、または無効な場合のステータス。エラーコードは unauthorized で、期待されるヘッダーを示すメッセージが付きます。

Once

キー全体が表示されるタイミング。作成時またはローテーション時に表示され、その後は先頭の数文字だけが見えます。

リクエストはどのように認証されますか?

すべてのリクエストは、https://easycoexistence.com/api/v1 に対して、キーを Authorization ヘッダーの Bearer トークンとして送信します。ほかに署名やスコープの指定はありません。キーがアカウントを識別し、リクエストが作成または読み取るすべてのデータはそのアカウントに属します。ボディは JSON 形式で、すべてのエラーは code と message を含むオブジェクトとして返されます。

List the account's numbers
curl https://easycoexistence.com/api/v1/connections \
  -H "Authorization: Bearer $EC_API_KEY"

キーはどこで作成しますか?

ダッシュボードでも AI アシスタントからでも、結果は同じです。ダッシュボードでは「Profile」を開き、「Developers」を選んで「Create API key」を押します。easyCoexistence の MCP サーバーに接続された Claude、ChatGPT などの AI アシスタントでは、Partner API のセットアップを依頼してください。get_partner_setup で不足している項目が分かり、create_api_key がキーを返します。いずれの場合も、キー全体は一度だけ表示されるため、バックエンドのシークレットにすぐ保存してください。

キーが一度しか表示されないのはなぜですか?

保存されるのはキーのハッシュだけだからです。easyCoexistence はリクエストごとの照合用にハッシュを保持しています。加えて、キーの先頭部分(ec_live_ とその後の 6 文字)も保存されるため、ダッシュボードでどのキーが有効で、いつ作成されたかを表示できます。紛失したキーは再表示できず、ローテーションによって置き換えます。

キーをローテーションまたは無効化するにはどうしますか?

一度の操作で行い、古いキーはその時点で直ちに使えなくなります。猶予期間はありません。キーが漏えいすることが、ローテーションを行う一般的な理由だからです。新しいキーは最初のキーと同様に一度だけ表示されます:

  • ダッシュボード:「Profile」、「Developers」、「Rotate key」の順に選択します。
  • MCP:replace_existing を true に設定して create_api_key を実行します。指定しない場合、キーが存在するとツールは実行を拒否するため、動作中の連携が誤って壊れることはありません。
  • すべてのアクセスを止めるには、代わりに無効化します。ダッシュボードの「Revoke」、または confirm を true にして revoke_api_key を実行してください。その後は、新しいキーが作成されるまでリクエストは失敗します。

キーがない、または誤っている場合はどうなりますか?

コードが unauthorized の 401 が返されます。対象は、Authorization ヘッダーがないリクエスト、ec_live_ で始まらないキー、ローテーションまたは無効化されたキーです。メッセージには期待されるヘッダー名が含まれます。同じアドレスから失敗したリクエストが続く場合は、代わりに 429 rate_limited が返され、再試行までの待ち時間が秒単位で示されます。

401 Unauthorized
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
  }
}

有効なキーでも拒否されるのはどのような場合ですか?

有効なキーはアカウントを認証しますが、アカウントの状態は引き続き適用されます。これらは同じ形式のエラーで返されます:

  • 402 billing_required:アカウントにまだカードがないため、接続セッションを開始できません。
  • 404 not_found:この id は、このアカウントのどの接続、チャネル、セッションにも属しません。他のアカウントのものも含みます。
  • 409 removed:接続は削除されているため、その Webhook を変更できません。
  • 402 suspended:サブスクリプションが失効したため接続は停止中です。先に再接続してください。
  • 429 cap_reached または rate_limited:開いている接続セッションが多すぎる、または 1 時間あたりの作成数が多すぎます。

よくある間違い

  • キーをフロントエンドのコードに置くこと。ページを開いた人は誰でもキーを読み取れ、あなたに課金される接続を作成したり、?credentials=1 を付けてお客様のトークンを取得したりできてしまいます。
  • バックエンドが新しいキーを受け付けられる状態になる前にローテーションすること。古いキーは直ちに無効になるため、新しいキーがデプロイされるまで、すべてのリクエストが 401 で失敗します。
  • 共有している会話でキーを作成すること。create_api_key はキーをチャットに返すため、そのキーは履歴に残ります。会話を共有している場合は、キーをローテーションしてください。
  • キーを引用符で囲んで保存すること。Bearer の後ろのすべてがキーとして読み取られるため、引用符付きの値は一致せず、すべてのリクエストが 401 になります。
EasyCoexistence で実現する

easyCoexistence は、アカウントごとに Partner API キーを 1 つ発行します。これにより、バックエンドから顧客の WhatsApp 番号と、その Instagram、Facebook、TikTok、YouTube、LinkedIn アカウントを接続し、さらに他のチャネルにも対応できます。接続ごとの認証情報を読み取り、そのイベントを振り分けることもできます。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。

よくある質問

アカウントで API キーを複数持てますか?

いいえ。アカウントが同時に持てるキーは 1 つで、新しく作成すると置き換えられます。キーを分けたい場合は、別々の easyCoexistence アカウントを作成してください。それぞれに独自の接続と請求があります。

Partner API キーの有効期限はありますか?

ありません。キーは、ローテーションまたは無効化されるまで、あるいは Meta のルールを悪用したとして easyCoexistence が停止するまで有効です。

お客様が接続するにはキーが必要ですか?

いいえ。お客様はホストされた接続リンクを開くだけで、そのリンク自体が独自のセッション id を持っています。キーはサーバー上に残り、バックエンドだけが使用します。

API キーとイベント署名シークレットは同じものですか?

いいえ。キーは API へのリクエストを認証します。署名シークレットは、ステータスイベントの URL を設定したときに一度だけ表示され、エンドポイントが easyCoexistence から送られるイベントを検証するために使います。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日