Partner API の認証:Bearer ec_live_ キー、ローテーション、401 エラー
Partner API のすべてのリクエストは、アカウントの秘密キーを Authorization: Bearer ec_live_… ヘッダーに含め、サーバーから送信します。easyCoexistence のアカウントごとにキーは1つあり、ダッシュボードの「Profile」「Developers」から作成するほか、AI アシスタントに create_api_key の実行を頼んでも作成できます。キーは一度だけ表示されます。ローテーションを行うと新しいキーが発行され、古いキーは直ちに無効になります。キーがない場合や誤っている場合は 401 unauthorized が返されます。
すべての Partner API キーの先頭に付く接頭辞。各リクエストでは Authorization: Bearer として送信します。
アカウントが同時に保持できるキーの数。このキーで作成されたすべての接続は、そのアカウントに属します。
キーがない場合、または無効な場合のステータス。エラーコードは unauthorized で、期待されるヘッダーを示すメッセージが付きます。
キー全体が表示されるタイミング。作成時またはローテーション時に表示され、その後は先頭の数文字だけが見えます。
リクエストはどのように認証されますか?
すべてのリクエストは、https://easycoexistence.com/api/v1 に対して、キーを Authorization ヘッダーの Bearer トークンとして送信します。ほかに署名やスコープの指定はありません。キーがアカウントを識別し、リクエストが作成または読み取るすべてのデータはそのアカウントに属します。ボディは JSON 形式で、すべてのエラーは code と message を含むオブジェクトとして返されます。
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 が返され、再試行までの待ち時間が秒単位で示されます。
{
"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 は、アカウントごとに 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 監視
確認日