API 密钥

API 密钥让脚本、内部工具和 AI 助手以你的账号调用 REST API 和 MCP 服务。密钥只在创建时显示一次，服务器只保存它的哈希。这一页说明怎么创建、权限范围是什么、哪些操作需要单独授权，以及怎么撤销。

在哪里

左下角的账户菜单里有 API 密钥入口，页面标题是 API 密钥。页面说明是：用于 REST API 和 MCP 的密钥，仅限当前账号。

创建密钥

1. 点 创建密钥。
2. 填 名称。名称会显示在列表里，最多 32 个字符。
3. 选 有效期：30 天、90 天、1 年 或 永不过期。默认是 90 天；到期后密钥自动失效。
4. 检查 权限范围，见下一节。
5. 需要发送外联时勾选 允许跟进操作。
6. 点 创建密钥。
7. 在 复制你的 API 密钥 对话框里复制密钥。这是唯一一次显示；关闭后只能撤销并重新创建。点 复制，保存到安全的地方，再点 完成。

密钥是一串 64 个字母，没有固定前缀。列表里显示前 6 位，后面用点代替。

权限范围

创建对话框列出每个密钥默认带有的范围：

范围	可以用来
Target 读写	读取和修改目标客户、条目、搜索、信息富集列、监控、导入，以及查询额度余额和任务
事件读取	读取事件列表和单个事件
Webhook 写入	创建、修改、删除 Webhook；读取 Webhook 使用 Target 读写
调研读取	读取公司调研报告
联系人读取	读取联系人
海关数据读取	读取海关数据

有了后三项范围，MCP 里的调研、联系人和海关工具可以直接使用。外联发送不在默认范围内。

外联发送单独授权

默认密钥不能发消息，也不能点赞。勾选 允许跟进操作 后，密钥才带有外联权限；说明文字是 发送消息 / 点赞 LinkedIn 帖子。勾选时页面会显示警告：任何持有此密钥的人都能以你的账号发送消息。只应授予可信的集成。

即使授权，MCP 工具也只能对已有会话或已有联系人发送单条消息，没有群发。每条发出去的消息按 客户互动 计费，见 额度如何计算。

使用密钥

两种请求头都可以：

curl "https://www.renewsell.com/v1/targets" \
  -H "x-api-key: $RENEWSELL_API_KEY"

curl "https://www.renewsell.com/v1/credits" \
  -H "Authorization: Bearer $RENEWSELL_API_KEY"

密钥代表你的账号，按上面的权限范围生效。请求超过频率上限时返回 429，按 Retry-After 等待后重试，见 REST API 概览。

撤销与到期

• 在列表里点 撤销密钥，确认 撤销此 API 密钥？ 后点 撤销。撤销立即生效，使用它的请求马上失败，且无法恢复。
• 到期的密钥状态显示 已过期，请求同样失败。
• 列表显示 最近使用；从未用过显示 从未使用。发现异常先撤销，再创建新密钥。

常见问题

密钥应该放在哪里？ 服务器环境变量或密码管理器里。不要写进网页前端、客户端安装包或代码仓库。

可以把密钥给同事用吗？ 密钥代表你的账号。拿到密钥的人能做权限范围内的事，包括勾选授权后的发信。

丢失的密钥能找回吗？ 不能。服务器只保存哈希，只能撤销后重新创建。