API 密钥是一串字符,你在每次请求的 X-API-KEY 头里发送它。它标识的是组织,不是人,也不是 LinkedIn 账号 — 一把密钥能够到那个组织连接过的每一个 LinkedIn 账号,别的一个也够不到。
它不是什么
- 不是按 LinkedIn 账号发的。账号是在请求里指名的,不在密钥里。
- 不是按地址发的。同一把密钥在每一个 /linkedin 路由上,以及你的助手使用的 MCP 地址里,都能用。
- 拿不回来。完整的密钥你只在创建时看一次。之后我们只留下够用来校验的部分。
值得避开的那个错误
放进 URL 的密钥会落到日志里 — 你的、我们的,以及中间每一道代理的。这个 API 唯一把密钥放进 URL 的地方是 MCP 地址,而那个地址是用来粘进助手设置里的,不是用来访问、链接或分享的。如果你把它粘到了人能看见的地方,就新建一把密钥,把那把吊销掉。
怎么轮换
先建新密钥,部署上去,然后再吊销旧的。反过来做会留下一个什么都不转的窗口,而那个窗口的长度,恰好等于你最慢的一次发布。
两把密钥同时有效是可以的,而且本来就是这个意思:没有任何东西把密钥绑到某个会话上,所以没有状态需要迁移。吊销从下一次请求开始生效,而不是等到什么东西结束。
常见问题
项目房间会用到我的某把 API 密钥吗?
它会自己生成一把,名为项目房间,在你勾选了 MakeHybrid 的某个 AI 智能体第一次需要时生成。在控制台里吊销它,下一次智能体调用就会生成一把新的。
房间里的 AI 密钥和这把密钥是一回事吗?
不是。AI 密钥来自 Anthropic、OpenAI 或 xAI,为智能体的思考付费。这把密钥决定它可以指名哪些 LinkedIn 账号。房间总是需要前者,只有要在 LinkedIn 上操作时才需要这一把。