API 문서

Shifton API 연결 및 작업

Shifton API는 일정 관리부터 외부 HR급여, 및 분석 시스템과의 통합까지 플랫폼의 모든 주요 기능에 액세스할 수 있습니다..
API를 사용하여 프로세스를 자동화하고 Shifton을 회사의 내부 서비스와 연결할 수 있습니다.

API 문서

문서는 다음 두 가지 버전을 지원합니다:

• 📄 구 버전 문서 — 기존 통합을 위한 이전 API 참조(여전히 지원됨):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 신 버전 문서 — 업데이트된 구조와 최신 메서드를 포함한 현재 API 버전:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

시작하기

API 키 받기

Shifton 플랫폼의 회사 설정에서 API 키.
를 생성합니다. 인증은 헤더를 통해 수행됩니다:

첫 번째 요청 보내기

예를 들어, 직원 목록을 가져오려면:

예시 응답:

API를 작업 흐름에 통합하기

• 자동으로 근무 교대 및 수정

• 휴가 및 병가 요청 관리

• 급여 시스템으로 데이터 내보내기

• 맞춤 대시보드 및 보고서 작성

핵심 API 기능

• 직원 – 추가, 편집 및 역할 관리

• 일정 – 교대 근무 생성, 조정 및 작업 계획

• 휴가 및 결근 – 휴가 및 병가 신청 관리

• 보고 – 시간, 급여 및 출석 데이터 내보내기

오류 코드

Shifton API는 표준 HTTP 상태 코드를 사용합니다:

• 200 — 요청 성공

• 201 — 객체 생성 성공

• 400 — 잘못된 매개변수

• 401 — 인증 오류 (잘못된 API 키)

• 403 — 접근 거부

• 404 — 리소스를 찾을 수 없음

• 500 — 서버 오류

사용 팁

• 항상 새로운 API 버전을(를) 사용하여 새 통합을 수행하십시오

• 사용 Postman 또는 curl 로 테스트하기

• 속도 제한을 준수하여 차단을 피하세요

• 아직도 오래된 문서에 의존하는 통합 업데이트하기