본문으로 건너뛰기
G 기그 Open API v1

참고

제공하지 않는 것

요청이 들어와도 제공하지 않는 항목과, 기그의 데이터 구조상 불가능한 것을 미리 밝힙니다.

개인정보

아래는 어떤 스코프·어떤 계약으로도 제공하지 않습니다.

  • 주민등록번호, 외국인등록번호
  • 계좌번호, 은행코드
  • 상세주소
  • 생년월일
  • 연락처(전화번호)
  • 출퇴근 위치 좌표 원본
i

직원 식별자는 가명 처리됩니다

staff_id 는 회원별·매장별로 다른 값입니다. 서로 다른 회원이 받은 값을 대조해 동일인을 판별할 수 없습니다.

데이터

  • 매출 — 기그가 보유하지 않습니다. 따라서 인건비도 계산해 드릴 수 없습니다. 매출은 직접 결합하셔야 합니다.
  • 급여 실지급액·공제액 — 급여 확정은 기그의 책임 범위를 넘습니다. 산정에 필요한 기초정보까지만 제공합니다.
  • 수당 금액 분해 — 야간·연장·주휴 가산액은 저장되어 있지 않습니다. 시간과 플래그만 제공합니다.
  • 근로계약서 원문·서명 — 제공하지 않습니다.
  • 반복 스케줄 규칙 — 전개된 날짜별 결과만 제공합니다.
  • 타 매장 벤치마크 — 다른 사업자의 데이터입니다.

기능

  • 쓰기 API — 이 API 는 읽기 전용입니다. 생성·수정·삭제가 없습니다.
  • Webhook — 준비 중입니다. 현재는 증분 조회로 동기화하세요.
  • 직원 순위·평가 지표 — 인사평가 목적의 사용은 이용약관상 금지됩니다.

알려진 한계

기그의 데이터 구조에서 비롯된 것으로, 회피할 수 없는 제약입니다.

  • 매장 폐업 여부를 알 수 없습니다. 폐업한 매장이 목록에 남을 수 있습니다. 최근 근무 기록 유무로 판단하는 편이 정확합니다.
  • 한 사업자번호로 점포 두 곳을 운영하면 구분되지 않습니다. 데이터가 합산됩니다.
  • 주당 계약 근무시간은 정규직만 원천 데이터가 있습니다. 그 외 고용형태는 null 입니다.
  • 증분 조회로 삭제를 감지할 수 없습니다. 주기적인 전체 재조회가 필요합니다.
  • 스케줄 기능을 끈 매장은 지각·조퇴·대타 판정이 불가능합니다. judgment_available: false 로 표시되며 카운트는 null 입니다.
  • 출퇴근 기록과 근무 기록을 잇는 식별자를 제공하지 않습니다. 두 데이터를 1:1 로 매칭할 수 없습니다. 날짜·직원·시각으로 근사 매칭해야 합니다.