MakeHybrid webhooks (POST /premium/webhooks/endpoints) は /premium/webhooks/endpoints に対する POST で、MakeHybrid Premium API の webhooks ファミリーに属します。すべてのリクエストは X-API-KEY ヘッダーに自分のキーを載せます。キーがどの組織であるかを決め、したがってどの LinkedIn アカウントを指定できるかも決めます。
Webhook は、知らされることと尋ね続けることの違いです。配信ごとに署名を検証し、同じイベントの再送はふつうのこととして扱ってください。
リクエスト
curl -X POST "https://makehybrid.com/premium/webhooks/endpoints" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
うまくいかないときに返るもの
- 401 — キーがない、誤っている、または失効している。
- 402 — プランが未払い。試用期間が終わると Premium はこれを返します。
- 404 — 対象が存在しないか、そのアカウント id が自分のものではないか。id を探られないよう、両者は意図的に同じ答えにしています。
- 429 — リクエストが多すぎるか、LinkedIn がそのアカウントを抑えています。待つ以外に手はなく、早く再試行するほど長引きます。
- 503 — LinkedIn、またはその手前のホップが応答しませんでした。本文には見えたままの素のステータスが入ります。
エラーはすべて同じ形の JSON です: {"type":"errors/<code>","status":<n>,"detail":"..."} — ハンドラ 1 つで全部を受けられますし、detail は人に見せるために書かれています。
代わりにアシスタントに頼む
この操作は MCP ツールでもあります。https://makehybrid.com/mcp/<自分の API キー> を Claude や ChatGPT、あるいは MCP を話すアシスタントに貼り付けて、ふつうの言葉で頼んでください。アシスタントが呼び出しを選び、id を埋め、答えを読み上げます。インストールするものはありません。
どのプランか
Premium プラン、/premium 上。接続した LinkedIn アカウント 1 つにつき月 9 ドル、10 アカウントからは 7 ドル、1000 からは 5 ドル。1 アカウント分の 30 日間試用つき。