참고
변경 이력
API 변경 사항과 호환성 정책입니다.
릴리스
v1 (예정) 준비 중
- 매장·직원·출퇴근 기록·근무 기록·근무 스케줄·급여 기초정보 조회
- 통계 — 근무시간·인건비 요약, 시간대별·요일별 분포, 근태 품질, 직원별 집계
- OAuth 2.0 client credentials 인증, 고용주 계정 연결
- 커서 페이지네이션, 증분 조회, 사용량 조회
예정
- 예정 대비 실제 통계 — /stats/schedule-adherence
- Webhook — 출퇴근·근무기록·스케줄 변경, 연결 해제 이벤트
- 가맹점 동의 연결 — 본사가 요청하고 점주가 승인하는 흐름
- 삭제 이벤트 기반 증분 조회 — 전체 재조회 없이 삭제 감지
일정은 확정되지 않았습니다.
호환성 정책
i
응답 구조는 깨지 않습니다
필드를 삭제하거나 의미를 바꾸는 변경은 6개월 전에 공지하고, 그 기간 동안 새 버전과 병행
운영합니다.
아래는 사전 공지 없이 일어날 수 있습니다. 이에 견디도록 구현하세요.
- 응답에 새 필드가 추가되는 것 — 모르는 필드는 무시하세요.
- enum 에 새 값이 추가되는 것 — 모르는 값에 대한 기본 처리를 두세요.
message문구가 바뀌는 것 —code로 분기하세요.- 커서 문자열의 내부 형식이 바뀌는 것 — 디코딩하지 마세요.