인증과 연결
고용주 연결
가입만으로는 아무 데이터도 볼 수 없습니다. 고용주 계정을 연결해야 그 매장의 데이터가 열립니다.
왜 연결이 필요한가
근태 데이터는 근로자의 개인정보이고, 그 데이터를 보유한 주체는 각 매장의 사업자입니다. API 회원 가입은 개발자 계정을 만드는 것일 뿐, 그 자체로는 어떤 매장에 대한 권한도 주지 않습니다.
계정을 실제로 통제하는 사람만 연결할 수 있습니다. 이것이 이 API 의 인가 경계입니다.
연결 절차
- 포털의 매장 연결 메뉴에서 기그 사장님 계정으로 인증합니다.
- 인증에 성공하면 그 계정의 매장이 목록으로 표시됩니다.
- 연결할 매장을 직접 선택합니다. 자동으로 전부 연결되지 않습니다.
- 선택한 매장에 대해 어떤 스코프를 허용할지 정합니다.
- 연결 즉시 그 매장의 사장님에게 알림이 발송됩니다.
i
근로자 계정으로는 연결할 수 없습니다
사장님(고용주) 계정만 연결 대상입니다. 근로자 계정으로 인증을 시도하면 거부됩니다.
!
연결 시도에는 엄격한 제한이 걸려 있습니다
자격증명 반복 시도가 감지되면 계정과 IP 가 잠깁니다. 정상적인 연동에서는 문제가 되지 않지만,
자동화된 재시도 로직을 넣지 마세요.
매장이 여러 개인 경우
한 고용주가 매장을 여러 개 운영하면 기그에 이미 계정이 묶여 있습니다. 계정 하나로 인증하면 나머지 매장이 함께 후보로 표시되므로, 매장마다 따로 인증할 필요가 없습니다.
다만 연결은 매장 단위로 선택합니다. 후보에 떴다는 이유로 자동 연결되지 않습니다.
가맹점
가맹점주는 본사와 별개의 사업자입니다. 본사가 가맹계약을 맺었다는 사실만으로는 가맹점의 근태 데이터에 접근할 수 없습니다.
- 직영점 — 본사가 그 매장의 사업자이므로 본사 계정으로 바로 연결됩니다.
- 가맹점 — 점주 본인이 연결하거나, 점주의 개별 동의가 필요합니다.
i
가맹점 동의 기능은 준비 중입니다
현재는 점주가 직접 자신의 계정으로 연결하는 방식만 지원합니다. 본사가 요청을 보내고 점주가
승인하는 흐름은 이후 제공될 예정입니다.
연결 해제
연결은 양쪽 모두 끊을 수 있습니다.
- API 회원 — 포털의 매장 목록에서 해제
- 매장 사장님 — 기그 사장님 앱·웹의 연결 관리 화면에서 해제
해제되는 즉시 그 매장에 대한 모든 조회가 404 를 반환합니다. 이미 받아간 데이터는
이용약관에 따라 삭제해야 합니다.