登录开始免费试用
easyCoexistence 官方 API

Partner API 身份验证:Bearer ec_live_ 密钥、轮换与 401 错误

每个 Partner API 请求都会在 Authorization 标头中携带账户的密钥,格式为 Authorization: Bearer ec_live_…,并由您的服务器发送。每个 easyCoexistence 账户只有一个密钥,可在控制台的“个人资料”下的“开发者”中创建,也可以请 AI 助手运行 create_api_key,且密钥仅显示一次。轮换会签发新密钥,并立即使旧密钥失效;密钥缺失或错误时,将返回 401 unauthorized。

ec_live_

每个 Partner API 密钥都以此开头,每次请求都通过 Authorization: Bearer 发送。

1 key

账户同一时间持有的密钥数;用其建立的每个连接都归属该账户。

401

缺失或无效密钥的状态码,错误代码为 unauthorized,消息会指出预期的标头。

Once

完整密钥的显示时机:创建或轮换时显示一次,之后仅可见前几个字符。

请求如何认证?

每个请求都需在 Authorization 标头中携带该密钥作为 Bearer 访问令牌,发送至 https://easycoexistence.com/api/v1。除此之外无需签名,也不设作用域:密钥用于识别账户,请求创建或读取的一切内容都归属该账户。请求体为 JSON,所有错误均以包含 code 和 message 的对象返回。

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

在哪里创建密钥?

可在控制台中创建,也可通过 AI 助手创建,结果相同。在控制台中,打开“个人资料”,再进入“开发者”,然后点击“创建 API 密钥”。在 Claude、ChatGPT 或其他连接到 easyCoexistence MCP 服务器的助手中,请它设置 Partner API:get_partner_setup 会显示缺少的内容,create_api_key 会返回密钥。无论哪种方式,完整密钥都只显示一次,因此请立即将其存入后端的机密配置中。

为什么密钥只显示一次?

因为系统只存储其哈希值。easyCoexistence 保留哈希用于校验每个请求,并保存密钥的前几个字符,即 ec_live_ 及另外六个字符,以便控制台显示当前有效的是哪个密钥以及创建时间。丢失的密钥无法再次显示;轮换即可将其替换。

如何轮换或撤销密钥?

只需一步,旧密钥会在那一刻停止工作,没有宽限期,因为密钥泄露通常是轮换的原因。新密钥与首次一样只显示一次:

  • 控制台:进入“个人资料”、“开发者”,点击“轮换密钥”。
  • MCP:调用 create_api_key 并将 replace_existing 设为 true。若不设置,密钥存在时该工具会拒绝执行,从而避免正在运行的集成因误操作而中断。
  • 若要停止所有访问,请改为撤销:在控制台中点击“撤销”,或调用 revoke_api_key 并将 confirm 设为 true。此后请求会失败,直到创建新密钥。

缺失或错误的密钥会返回什么?

对于没有 Authorization 标头的请求、不以 ec_live_ 开头的密钥,或已被轮换或撤销的密钥,返回 401 及错误代码 unauthorized。消息会指明预期的标头。当同一地址持续发送失败请求时,API 会改为返回 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:未关闭的连接会话过多,或本小时内创建的会话过多。

常见错误

  • 将密钥放在前端代码中。任何打开页面的人都能读取它,从而以您的名义创建计费连接,并通过 ?credentials=1 获取您客户的访问令牌。
  • 在后端尚未能使用新密钥之前就轮换。旧密钥会立即失效,因此在新密钥部署之前,每个请求都会返回 401。
  • 在共享的对话中创建密钥。create_api_key 会将密钥返回到聊天中,它会保留在对话历史里,因此如果该对话被共享,请轮换密钥。
  • 给密钥加上引号。Bearer 之后的全部内容都会被读作密钥,因此带引号的值永远无法匹配,每个请求都会得到 401。
使用 EasyCoexistence 完成这些操作

easyCoexistence 为每个账户提供一个 Partner API 密钥,让您的后端可以连接客户的 WhatsApp 号码,以及他们的 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 账户,还有更多渠道,然后读取每个连接的凭据并分发其事件。每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,且首 3 天免费试用。

常见问题

一个账户可以有多个 API 密钥吗?

不可以。账户同一时间只有一个密钥,创建新密钥会替换旧密钥。若需要分开的密钥,就需要分开的 easyCoexistence 账户,每个账户都有各自的连接和各自的账单。

Partner API 密钥会过期吗?

不会。密钥在被轮换、撤销,或因违反 Meta 规则被 easyCoexistence 终止之前一直有效。

我的客户需要我的密钥才能连接吗?

不需要。他们只需打开托管的连接链接,该链接自带会话 id。密钥保留在您的服务器上,且仅由您的后端使用。

API 密钥与事件签名密钥相同吗?

不相同。API 密钥用于向 API 验证您的请求。签名密钥会在您设置状态事件 URL 时显示一次,用于让您的端点验证 easyCoexistence 发送的事件。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间