GET https://oapi.greetinghr.com/openapi/v2/events
필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
X-Greeting-OpenAPI | String | 필수 | 발급받은 API Key 입니다. 이벤트 API 권한이 켜져 있어야 합니다 |
필드 | 타입 | 필수 여부 | 설명 | 파라미터 타입 |
|---|---|---|---|---|
after | String | 선택 | 커서입니다. 이 값 이후의 이벤트부터 반환합니다. 최초 조회 시에는 생략합니다. 응답의 nextCursor 값을 그대로 사용하세요 | Query |
limit | Number | 선택 | 한 번에 반환할 최대 개수입니다. 기본값 50, 최대 100. 범위를 벗어난 값은 자동으로 보정됩니다 | Query |
eventType | String | 선택 | 특정 이벤트 종류만 조회합니다. 미입력 시 전체 종류를 반환합니다 | Query |
after는 해석 불가능한 문자열입니다.
값을 해석하거나 직접 계산·추측하지 말고, 응답에서 받은 값을 그대로 되돌려주세요. 형식이 올바르지 않으면 오류로 응답합니다. (처음부터 다시 조회되지 않습니다)
eventType은 아래 이벤트 종류 8종 중 하나여야 합니다.
그 외 값을 넣으면 오류로 응답합니다.
공통 응답 객체로 감싸져 반환됩니다. 아래는 data 의 구조입니다.
이 API는 커서 방식이므로 공통 응답 객체 문서의 페이지네이션 응답(page·totalCount·hasNext 등)과 형태가 다릅니다.
전체 개수와 페이지 번호는 제공되지 않습니다.
필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
events | Object[] | 필수 | 조회된 이벤트 목록입니다. 오래된 순(oldest-first) 으로 정렬됩니다. 조회 결과가 없으면 빈 배열입니다 |
nextCursor | String | 선택 | 다음 조회에 사용할 커서입니다. 저장해 두고 다음 요청의 after로 넘기세요. 조회 결과가 없으면 null 이며, 이때는 기존 커서를 그대로 유지합니다 |
hasMore | Boolean | 필수 | 아직 가져오지 않은 이벤트가 남아 있는지 여부입니다. true면 즉시 다음 페이지를 이어서 조회하세요 |
모든 이벤트는 아래 공통 봉투 구조를 가집니다. 이벤트별 상세는 data에 담기며, 필드 구성은 이벤트 종류마다 다릅니다.
필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
eventId | String | 필수 | 이벤트 고유 식별자(UUID)입니다. 중복 수신 제거(dedupe) 키로 사용하세요 |
eventType | String | 필수 | 이벤트 종류입니다. 아래 8종 중 하나입니다 |
occurredAt | String | 필수 | 이벤트 발생 시각입니다. ISO-8601 UTC이며 Z로 끝납니다 (예: 2026-07-24T01:15:30Z) |
workspaceId | Number | 필수 | 워크스페이스 고유 번호(id)입니다 |
data | Object | 필수 | 이벤트별 상세 정보입니다. 이벤트 종류별 필드는 아래 문서를 참고하세요 |
값이 없는 필드는 키 자체가 생략됩니다. 항상 존재한다고 가정하지 말고 없을 때를 처리하세요.
이어서 조회할 때는 직전 응답의 nextCursor를 after로 넘깁니다.
조회 결과가 없는 경우입니다.
{
"success": true,
"data": {
"events": [],
"nextCursor": null,
"hasMore": false
},
"message": null,
"errorCode": null
}최초에는 after 없이 호출합니다.
받은 이벤트를 먼저 처리합니다.
처리가 끝난 뒤에 nextCursor를 저장합니다.
hasMore가 true면 저장한 커서로 즉시 다음 페이지를 조회합니다.
커서는 처리 완료 후에만 저장하세요.
저장 전에 중단되면 같은 이벤트를 다시 받게 되는데, eventId로 중복을 제거하면 안전합니다.
반대로 처리 전에 저장하면 이벤트를 영구히 놓칩니다.
eventType | 설명 |
|---|---|
APPLICANT_REGISTERED | 지원자 등록(지원서 제출) |
APPLICANT_PROCESS_MOVED | 채용단계 이동 |
APPLICANT_PASSED | 합격 |
APPLICANT_PASS_REVOKED | 합격 취소 |
APPLICANT_REJECTED | 불합격 |
APPLICANT_REJECTION_REVOKED | 불합격 취소 |
EVALUATION_ASSIGNED | 평가 부여(배정) |
EVALUATION_COMPLETED | 평가 완료 |
항목 | 내용 |
|---|---|
요금제 | Business 플랜 전용입니다 |
권한 | Open API 키에 이벤트 API 권한이 켜져 있어야 합니다. 워크스페이스 설정 → Open API 메뉴에서 설정합니다 |
조회 범위 | API 키가 속한 워크스페이스로 고정됩니다. 다른 워크스페이스의 이벤트는 조회할 수 없습니다 |
보관 기간 | 이벤트는 7일 보관됩니다. 이후에는 조회할 수 없으므로 최소 하루 1회 이상 조회하세요 |
수집 시작 시점 | 설정 이전에 발생한 이벤트는 제공되지 않습니다. 이벤트 API 권한을 켠 시점 또는 웹훅을 등록한 시점부터 수집이 시작되며, 과거 데이터 소급 제공(backfill)은 지원하지 않습니다 |
중복 가능 | 같은 이벤트가 두 번 이상 조회될 수 있습니다(at-least-once). eventId로 중복을 제거하세요 |
정렬 | 항상 오래된 순입니다. 최신순 조회는 제공하지 않습니다 |
테스트 발송 | 웹훅 설정 화면의 테스트 발송(WEBHOOK_TEST)은 이 API에 나타나지 않습니다 |