2분이면 되고, 무엇보다 먼저 해 둘 값어치가 있습니다. 나중에 나오는 연동 문제의 거의 전부가 이것이 확인해 주는 두 가지 중 하나로 드러납니다.
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 필드는 사람에게 보여 주려고 쓰인 것이니, 보여 주는 편이 대체로 옳습니다.
자주 묻는 질문
첫 호출을 채팅에서 할 수 있나요?
네. 어시스턴트를 연결하고 어떤 계정이 연결되어 있는지 물어보세요. 같은 종류의 호출을 하고 답을 읽어 줍니다. 그래도 한 번은 직접 해 볼 만합니다. 여기서 보는 오류의 모양이 AI 에이전트가 읽게 될 오류의 모양이기도 하기 때문입니다.
프로젝트 룸에 이 키가 필요한가요?
룸을 열거나 내장 AI 에이전트에게 물어보는 데는 필요 없습니다. LinkedIn에서 행동하는 내 에이전트만 키가 필요하며, 그 키는 룸이 스스로 만듭니다.