你的第一次 API 调用

两分钟，值得在别的任何事之前做：后面几乎每一个集成上的麻烦，到头来都是这件事所证明的两样之一。

1. 创建一把密钥

在控制台上“创建密钥”。完整的密钥你只看一次。把它放在你的代码从环境里读、而不是从仓库文件里读的地方。

2. 问问你手上有什么

curl "https://makehybrid.com/linkedin/connect/accounts" \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

有回应，就说明密钥有效、套餐在生效，而返回的那份清单，就是你的组织连接过的每一个 LinkedIn 账号。两件事得到了证明，而其他每一次调用都需要的那一项输入 — 账号 id — 也在一次完全不碰 LinkedIn 的请求里拿到了。

3. 现在就把错误的形状学会

{"type":"errors/payment_required","status":402,"detail":"..."}

• 401 — 密钥缺了、错了，或者已经被吊销。
• 402 — 套餐没付费，或者试用期结束了。
• 404 — 不在那里，或者不是你的。有意给同一个答案。
• 429 — 请求太多，或者 LinkedIn 正在限这个账号的速。
• 503 — LinkedIn 前面那一跳没有回应；正文里带着它看到的那个光秃秃的状态。

针对这个形状写一个处理器，目录里的每一条路由就都盖住了。detail 这个字段本来就是写来给人看的，所以把它显示出来，通常就是对的做法。

常见问题