자동화 및 개발자
API 키
API 액세스를 인증하는 키를 생성하고, 범위를 설정하고, 교체하세요.
API 키는 PeekHire에 대한 프로그래밍 방식의 접근을 인증합니다 — REST API와 노코드 자동화 모두에 사용됩니다.
키 만들기
- 개발자 도구 → API 키 → 만들기로 이동하세요.
- 키의 용도를 기억할 수 있도록 설명이 담긴 이름(예: Zapier 연동)을 지정하세요.
- 키 값이 표시되면 복사하세요 — 보안을 위해 이후에는 다시 볼 수 없습니다.
키 사용하기
모든 요청에 키를 bearer 토큰으로 보내세요.
curl https://your-api-host/api/v1/applications \
-H "Authorization: Bearer YOUR_API_KEY"
권한
각 키에는 수행할 수 있는 작업을 제한하는 권한이 포함됩니다.
- 읽기 — 데이터를 가져옵니다(캠페인, 지원서, 사용자 목록 조회 및 상세 조회).
- 쓰기 — 데이터를 만들거나 수정합니다.
연동에 필요한 권한만 부여하세요(최소 권한). 읽기 전용 키만으로도 데이터를 스프레드시트나 대시보드에 동기화할 수 있습니다. 연동에서 PeekHire의 무언가를 변경해야 할 때만 쓰기를 추가하세요.
키 안전하게 관리하기
- 키를 비밀번호처럼 다루세요. 키를 가진 사람은 누구나 내 데이터에 접근할 수 있습니다.
- 키를 절대 저장소에 커밋하거나 클라이언트 측 코드에 넣지 마세요.
- 연동마다 별도의 키를 사용하세요. 그래야 다른 연동에 영향을 주지 않고 하나만 폐기할 수 있습니다.
- 키는 secrets manager 또는 사용 중인 도구의 자격 증명 저장소에 보관하고, 일반 텍스트로 저장하지 마세요.
키 교체 및 폐기
키가 노출되었거나 정기적으로 키를 교체하는 경우, 새 키를 만들고 연동을 업데이트한 다음 이전 키를 삭제하세요. 키를 삭제하면 해당 접근 권한이 즉시 폐기됩니다.