시작하기
빠른 시작
토큰 발급부터 첫 인건비 집계까지 순서대로 따라갑니다.
1. 가입과 키 발급
개발자 포털에서 가입하고 이메일 인증을 마치면 테스트 키가 바로 발급됩니다. 테스트 키는 고용주 연결 없이도 샌드박스에서 동작하므로, 계약 전에 개발을 시작할 수 있습니다.
gigp_test_…— 샌드박스 전용. 고정된 예제 데이터를 반환합니다.gigp_live_…— 운영. 연결된 실제 매장의 데이터를 반환합니다.
!
client_secret 은 한 번만 보입니다
발급 화면을 벗어나면 다시 볼 수 없습니다. 저희 쪽에도 원문이 남지 않습니다. 잃어버렸다면
키를 새로 발급하고 기존 키를 폐기하세요.
2. 액세스 토큰 발급
OAuth 2.0 client credentials 방식입니다. 발급된 토큰은 1시간 동안 유효합니다. 코드 블록 오른쪽 위에서 언어를 바꾸면 문서 전체의 예제가 함께 바뀝니다. 예제 안의 점선 그어진 값을 누르면 매장 ID·기간을 자기 값으로 바꿔 읽을 수 있습니다.
cURL
curl -sS -X POST "https://developer.openapi.giig.app/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=$GIG_CLIENT_ID" \
-d "client_secret=$GIG_CLIENT_SECRET" \
-d "scope=stores:read attendance:read"응답
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "stores:read attendance:read"
}i
토큰을 매 요청마다 발급하지 마세요
만료 전까지 재사용하고, 만료가 임박했을 때만 갱신합니다. 발급 요청도 레이트리밋 대상입니다.
3. 매장 목록 조회
연결한 고용주 계정의 매장이 나옵니다. 매장을 요청에 지정하지 않습니다 — 서버가 연결 정보로 범위를 정합니다.
cURL
curl -sS "https://developer.openapi.giig.app/api/v1/stores" \
-H "Authorization: Bearer $ACCESS_TOKEN"목록이 비어 있다면 아직 고용주 계정을 연결하지 않은 것입니다. 샌드박스에서는 연결 없이 예제 매장이 반환됩니다.
샌드박스
curl -sS "https://developer.openapi.giig.app/api/sandbox/v1/stores" -H "Authorization: Bearer $TEST_TOKEN"4. 근무 기록 조회
응답의 store_id 를 써서 한 달치 근무 기록을 가져옵니다. 기간은 최대 31일입니다.
cURL
curl -sS "https://developer.openapi.giig.app/api/v1/work-records?store_id=st_7Kq2&from=2026-08-01&to=2026-08-31&limit=500" \
-H "Authorization: Bearer $ACCESS_TOKEN"응답의 has_more 가 true 면 next_cursor 를 그대로 cursor 파라미터에 넣어 다음 페이지를 받습니다. 페이지네이션을 참고하세요.
5. 인건비 집계
직접 집계할 수도 있고, 통계 API 로 서버에서 받은 값을 쓸 수도 있습니다.
// 근무 기록의 시급 스냅샷으로 계산한다.
// 매장 설정의 기본급이 아니라 items[].hourly_wage 를 써야 소급 계산이 정확하다.
const cost = records.flatMap(r => r.items ?? []).reduce(
(sum, it) => sum + (it.hourly_wage ?? 0) * (it.work_minutes / 60),
0
);!
이 값은 추정치입니다
주휴수당, 4대보험 사업자 부담분, 소득세, 야간·연장 가산액이 포함되지 않습니다. 통계 API 응답의
excludes 배열이 제외 항목을 명시합니다.