경로: 워크스페이스 설정 → Open API 메뉴 → 키 발급
권한: 관리자(소유자·매니저) 이상만 발급/관리할 수 있습니다.
개수: 워크스페이스 당 1개의 Key 만 발급됩니다.
평문키는 발급 직후 한 번만 확인할 수 있습니다.
화면을 벗어나거나 새로고침하면 다시 확인할 수 없으니, 발급 즉시 복사해 안전한 곳에 보관하세요. 이후에는 앞/뒤 4자리만 남은 마스킹 형태로 표시됩니다.
재생성: 키가 유출됐거나 교체가 필요할 때 사용합니다. 기존 키는 즉시 무효화되며, 연동한 서비스에 새 키를 다시 등록해야 합니다. 권한 설정은 그대로 유지됩니다. 새 키도 재생성 직후에만 확인할 수 있습니다.
삭제: 삭제 즉시 해당 키를 사용하는 모든 요청이 거부됩니다.
발급한 키에는 사용할 API 범위(권한) 를 설정해야 합니다. 권한 설정 카드에서 필요한 권한을 켜고 끌 수 있습니다.
권한이 꺼진 API 를 호출하면 요청이 거부됩니다. 보안을 위해 연동에 필요한 권한만 켜는 것을 권장합니다.
공고 정보 API: 게시된 공고 목록, 공고 상세 조회
지원자 등록 API: 지원자 등록/수정, 파일 업로드, 채용단계 이동
지원자 정보 API: 합격자 목록, 지원자 상세 조회
평가 API: 평가 결과/상세 조회
설문 API: 설문 답변 조회
그리팅 API는 모든 기능을 REST API로 제공합니다. 요청 가능한 모든 API에 대해 X-Greeting-OpenAPI Headers로 사전에 발급 받은 API Key를 담아 요청하면 됩니다.
사용 예시는 다음과 같습니다.
curl --request GET \
--url 'https://oapi.greetinghr.com/openapi/all-jobs' \
--header 'X-Greeting-OpenAPI: <apiKey>'