はじめての API 呼び出し

2 分で済み、何より先にやる値打ちがあります。あとから出てくる連携の問題のほとんどは、これが確かめる 2 つのうちのどちらかに行き着きます。

1. キーを発行する

ダッシュボードで「キーを作成」。キー全体は一度だけ表示されます。リポジトリのファイルからではなく、環境から読める場所に置いてください。

2. 何を持っているか尋ねる

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

応答があれば、キーは有効でプランも生きています。そして返る一覧は、あなたの組織が接続したすべての LinkedIn アカウントです。2 つが確かめられ、他のどの呼び出しにも要る唯一の入力、つまりアカウント ID が、LinkedIn にまったく触れない 1 回の要求で手に入ります。

3. エラーの形を今のうちに覚える

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

• 401 — キーがない、間違っている、あるいは失効している。
• 402 — プランが未払いか、試用期間が終わっている。
• 404 — 存在しないか、あなたのものではない。意図して同じ答えにしてあります。
• 429 — 要求が多すぎるか、LinkedIn がアカウントを絞っている。
• 503 — LinkedIn の手前の中継が応答しなかった。本文には、そこが見た素のステータスが入ります。

この形に対してハンドラーを 1 つ書けば、カタログのすべての経路が覆えます。detail の項目は人に見せるために書かれているので、見せるのがたいてい正しい振る舞いです。

よくある質問