본문으로 건너뛰기
G 기그 Open API v1
읽기 전용 v1 · 15개 엔드포인트

매장의 근태 데이터를
그대로 가져다 쓰세요

기그를 쓰는 매장의 출퇴근·근무·스케줄·급여 기초정보를 조회하고, 인건비와 시간대별 근무 분포를 집계된 형태로 받아갑니다. 매장별 인건비 관리와 인력 운영 분석에 필요한 데이터가 여기 있습니다.

3단계면 첫 응답을 받습니다

  1. 1 가입하고 키 발급 이메일 인증만 하면 테스트 키가 바로 나옵니다.
  2. 2 고용주 계정 연결 연결한 매장의 데이터만 열립니다.
  3. 3 토큰 받아 호출 OAuth 2.0 client credentials.
첫 호출
curl -sS "https://developer.openapi.giig.app/api/v1/stores" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
응답
{
  "data": [
    {
      "store_id": "st_7Kq2",
      "display_name": "○○치킨 강남점",
      "staff_count": 12
    }
  ],
  "has_more": false
}

제공하는 데이터

시작하기 전에

!

인건비는 근무 기록으로 계산합니다

출퇴근을 찍지 않고 등록된 근무가 급여에는 반영됩니다. 출퇴근 기록만 쓰면 인건비가 과소 집계됩니다. 두 API 의 차이는 핵심 개념에서 설명합니다.
  • 매장 1개는 사업자등록번호 1개입니다. 한 사업자가 여러 점포를 운영하면 데이터가 합산됩니다.
  • 한 번에 조회할 수 있는 기간은 최대 31일입니다.
  • 식별자는 모두 불투명 값이며 회원마다 다릅니다.
  • 주민등록번호·계좌번호·연락처 등은 어떤 경우에도 제공하지 않습니다.
  • 쓰기 API 가 없습니다. 이 API 로 기그의 데이터를 바꿀 수 없습니다.