Получение резюме соискателя — это GET по /linkedin/v2/{account_id}/linkedin/jobs/{job_id}/applicants/{applicant_id}/resume, часть семейства linkedin в MakeHybrid API. Каждый запрос несёт ваш собственный ключ в заголовке X-API-KEY; ключ решает, какая вы организация, а значит, какие аккаунты LinkedIn вы можете назвать.
Это семейство передаёт запрос на собственную поверхность LinkedIn, поэтому форму ответа задаёт LinkedIn, а не мы.
Запрос
curl -X GET "https://makehybrid.com/linkedin/v2/$ACCOUNT_ID/linkedin/jobs/$JOB_ID/applicants/$APPLICANT_ID/resume" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Что идёт в путь
- account_id — подключённый аккаунт LinkedIn, от имени которого действуем. Это должен быть аккаунт, подключённый вашим же ключом; на любой другой id ответ будет 404.
- job_id — id, который вернул предыдущий вызов из этого семейства.
- applicant_id — id, который вернул предыдущий вызов из этого семейства.
Что приходит, когда не работает
- 401 — ключа нет, он неверный или отозван.
- 402 — тариф не оплачен. Тариф MakeHybrid API отвечает так, когда пробный период закончился.
- 404 — либо этого нет, либо id аккаунта не ваш. Оба случая намеренно дают один и тот же ответ, чтобы id нельзя было перебрать.
- 429 — слишком много запросов или LinkedIn придерживает аккаунт. Помогает только ожидание; повторить раньше — значит продлить его.
- 503 — LinkedIn или переход перед ним не ответил. В теле — голый статус, который он увидел.
Любая ошибка — это JSON одной и той же формы: {"type":"errors/<code>","status":<n>,"detail":"..."} — поэтому один обработчик покрывает все, а detail написан так, чтобы его можно было показать человеку.
Попросить ассистента
Эта операция ещё и инструмент MCP. Вставьте https://makehybrid.com/linkedin/mcp/<ваш ключ API> в Claude, ChatGPT или любого ассистента, говорящего на MCP, и попросите обычными словами — ассистент сам выберет вызов, подставит id и прочитает вам ответ. Устанавливать ничего не нужно.
В проектной комнате
В проектной комнате отметьте MakeHybrid в поле «Может использовать» у своего ИИ-агента — и он будет вызывать «Получение резюме соискателя» как инструмент всякий раз, когда это нужно разговору, в тех аккаунтах LinkedIn, которые подключила ваша организация. Все в комнате видят, о чём он спросил и что вернулось. Просите обычными словами; здесь агент называется @scout:
Частые вопросы
Может ли ИИ-агент вызвать «Получение резюме соискателя» за меня?
Да. Может любой ассистент, говорящий на MCP, — по адресу выше, — и ваш собственный ИИ-агент в проектной комнате с отмеченным MakeHybrid. Встроенные агенты комнаты не могут: они советуют, а ключа LinkedIn у них нет.
Работает ли это вне комнаты, из моего собственного кода?
Да. Запрос выше — это та же операция, которую вызывает инструмент ИИ-агента, с тем же ответом и теми же ошибками. Каким бы путём вы ни пришли, ваш ключ определяет, какие аккаунты LinkedIn он может назвать.
Работает ли это в комнате под моим собственным брендом?
Да. На адресе white-label инструмент указан под названием вашего продукта и достаёт до тех же аккаунтов по тем же правилам.
В каком тарифе
Тариф MakeHybrid API, на /linkedin. 9 $ за подключённый аккаунт LinkedIn в месяц, 7 $ от десяти аккаунтов и 5 $ от тысячи, с 30 днями пробного периода на один аккаунт.