Две минуты, и сделать это стоит раньше всего прочего: почти всякая последующая проблема интеграции оказывается одной из двух вещей, которые это проверяет.
1. Создайте ключ
«Создать ключ» в панели. Целиком вы видите ключ один раз. Положите его туда, откуда ваш код читает из окружения, а не из файла в репозитории.
2. Спросите, что у вас есть
curl "https://makehybrid.com/linkedin/connect/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Ответ означает, что ключ действителен, а план активен, и вернувшийся список — это каждый аккаунт LinkedIn, который подключила ваша организация. Две вещи подтверждены, и единственные входные данные, которые нужны любому другому вызову — идентификатор аккаунта, — в одном запросе, который LinkedIn не касается вовсе.
3. Выучите форму ошибок сразу
{"type":"errors/payment_required","status":402,"detail":"..."}
- 401 — ключа нет, он неверен или отозван.
- 402 — план не оплачен либо пробный период закончился.
- 404 — этого нет либо это не ваше. Один и тот же ответ нарочно.
- 429 — слишком много запросов либо LinkedIn придерживает аккаунт.
- 503 — узел перед LinkedIn не ответил; тело несёт голый статус, который он увидел.
Напишите один обработчик под эту форму, и каждый маршрут каталога закрыт. Поле detail написано так, чтобы показать его человеку, поэтому показать его обычно и есть правильное решение.
Частые вопросы
Можно ли сделать первый вызов из чата?
Да. Подключите ассистента и спросите, какие аккаунты подключены; он сделает вызов того же рода и прочитает ответ. Один раз вручную всё равно стоит сделать: вид ошибки, который вы здесь увидите, — тот же, который будет читать и ИИ-агент.
Нужен ли проектной комнате этот ключ?
Не чтобы открыть комнату или обратиться к встроенному ИИ-агенту. Ключ нужен только вашему агенту, который действует в LinkedIn, и его комната создаёт себе сама.