✅ 해당 기능이 제공되는 다우오피스 상품 유형
| 무료 | 서비스형 | 엔터프라이즈형 | ||
|---|---|---|---|---|
| 스탠다드 | 스탠다드 | 프리미엄 | 스탠다드 | 프리미엄 |
| ❌ | ❌ | ❌ | ✅ | ✅ |
Access Token 발행 API (공통 선행)
모든 OpenAPI 호출 전 반드시 Access Token을 먼저 발급받아야 합니다. 발급받은 Token은 이후 모든 API 호출의 Request Header에 포함됩니다.
📑Access Token 발행 API 상세 가이드
연차 이력 조회 API
연차 이력 조회 API는 임직원의 연차(휴가) 사용 정보를 외부 시스템에서 확인할 수 있도록 제공합니다.
사용자는 사원번호, 휴가 종류, 휴가일자, 사용 시간, 전자결재 문서번호 등 연차 관련 세부 데이터를 조회할 수 있으며, 조회 기간은 최대 31일까지 지정 가능하고, 페이지네이션을 지원합니다.
휴가 사용일뿐 아니라 휴가 결재의 승인·취소·반려 일시를 기준으로도 조회할 수 있습니다.
✔️ Request URL
https://api.daouoffice.com/public/api/attnd-v2/vacation
해당 API는 다우오피스 OpenAPI Request URL(api.daouoffice.com)을 사용합니다.
✔️ HTTP Method
GET Method로 별도 Content-Type 정의 없음 (Query String 기반)
✉️ Request Body
GET이므로 쿼리 파라미터와 헤더로 구성됩니다.
Headers
변수 |
타입 |
필수 | 사전발급 | 설명 |
|---|---|---|---|---|
Authorization |
String |
✅ | ✅ |
Authorization: Bearer {ACCESS_TOKEN} 반드시 헤더에 포함. “Bearer” 뒤 공백 1칸 필수 |
Query Parameters (고객사 → 시스템 연동)
변수 |
타입 |
필수 | 사전발급 | 설명 |
|---|---|---|---|---|
startDate |
String |
✅ | ⛔ | 조회 시작일(yyyy-MM-dd) 예) 2024-03-01 |
endDate |
String |
✅ | ⛔ | 조회 종료일(yyyy-MM-dd) 예) 2024-03-07 / 최대 31일 |
docStatusCode |
String |
⛔ | ⛔ | 조회 기준. APPROVAL, CANCEL, RETURN 중 |
page |
Number |
⛔ | ⛔ | 조회 페이지 (기본값 0) |
pageSize |
Number |
⛔ | ⛔ | 페이지 사이즈 (기본값 50) |
docStatusCode 값별 조회 기준
| 값 | 조회 대상 |
기간 기준 |
|---|---|---|
| 입력 안 함 | 결재 진행 중이거나 승인된 휴가 (승인 후 취소·반려된 결재 제외) |
휴가 사용일 |
| APPROVAL | 현재 승인 상태인 휴가 결재 |
결재 승인일시 |
| CANCEL | 승인 후 취소된 휴가 결재 |
결재 취소일시 |
| RETURN | 승인 후 반려된 휴가 결재 (강제반려 포함) |
결재 반려일시 |
docStatusCode 입력 시 유의사항
- 값은 대문자로만 인식합니다. approval처럼 소문자로 입력하면 요청 오류(400)가 발생합니다.
- 어떤 값을 입력해도 조회 기간은 최대 31일입니다.
취소·반려 결재 조회 범위
- 휴가 사용일이 지난 뒤 취소된 결재도 CANCEL로 요청하면 취소일시 기준으로 조회할 수 있습니다.
- 승인 후 취소·반려된 결재는 docStatusCode를 입력하지 않은 조회와 APPROVAL 조회 결과에 나오지 않습니다. CANCEL 또는 RETURN으로 조회해 주세요.
✉️ Request 예시
요청 예시 1 — 휴가 사용일 기준 조회
휴가 사용일이 2025년 9월인 휴가 기록을 첫 페이지부터 50건씩 조회합니다.
Authorization : Bearer {ACCESS_TOKEN}
요청 예시 2 — 취소된 휴가 결재 조회
2026년 9월 한 달 동안 취소된 휴가 결재를 조회합니다.
Authorization : Bearer {ACCESS_TOKEN}
📬Response Body
data 객체
변수 |
타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
code |
String | ✅ | ⛔ | API 호출 결과 코드 |
message |
String | ✅ | ⛔ | 호출 결과 메시지 |
data |
object | ✅ | ⛔ | 실제 페이징/목록 데이터 |
data 페이징 정보
변수 |
타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
totalCount |
Number | ✅ | ⛔ | 전체 데이터 건수 |
currentPage |
Number | ✅ | ⛔ | 현재 페이지 수. 요청값과 동일 |
pageSize |
Number | ✅ | ⛔ | 1페이지 표현 데이터 수. 기본값 50 |
totalPages |
Number | ✅ | ⛔ | 모든 페이지 수 예) totalPages 20 > 0 ~ 19page 로 조회 |
목록 데이터
변수 |
타입 | 필수 | 사전발급 | 제약 | 설명 |
|---|---|---|---|---|---|
employeeNumber |
String | ✅ | ⛔ | Nullable | 사용자 사원번호(EmpNo) |
platformUserId |
String | ✅ | ⛔ | Nullable | 다우오피스 사용자 내부 Primary Key |
loginId |
String | ✅ | ⛔ | Nullable | 다우오피스 사용자 로그인 ID |
name |
String | ✅ | ⛔ | Nullable | 다우오피스 사용자 이름 |
leaveCategoryName |
String | ✅ | ⛔ | Nullable | 휴가 이름 |
leaveCategoryCode |
String | ✅ | ⛔ | 휴가 코드 |
|
isPaidLeave |
Boolean | ✅ | ⛔ | Nullable | 유급휴가 여부 |
leaveDate |
String | ✅ | ⛔ | Nullable | 휴가 사용날 |
leaveStartTime |
String | ✅ | ⛔ | Nullable | 휴가 시작시간 ( yyyy-MM-dd HH:mm:ss ) |
leaveEndTime |
String | ✅ | ⛔ | Nullable | 휴가 종료시간 ( yyyy-MM-dd HH:mm:ss ) |
isAllDay |
Boolean | ✅ | ⛔ | Nullable | 종일휴가 여부 |
workReferenceDate |
String | ✅ | ⛔ | Nullable | 근무 귀속일 (yyyy-MM-dd) |
usedLeaveDuration |
String | ✅ | ⛔ | Nullable | 사용한 휴가 (hh:mm:ss) |
docId |
String | ✅ | ⛔ | Nullable | 전자결재 내부 Primary Key |
docNum |
String | ✅ | ⛔ | 전자결재 문서번호 |
|
docDraftedAt |
String | ✅ | ⛔ | Nullable | 상신 시점 ( yyyy-MM-dd HH:mm:ss ) |
docCompletedAt |
String | ✅ | ⛔ | 승인 시점 ( yyyy-MM-dd HH:mm:ss ) |
|
docStatusCode |
String | ✅ | ⛔ | 전자결재 상태 |
|
zoneId |
String | ✅ | ⛔ | 근무그룹 타임존 (서머타임 미적용 타임존) |
📬Response 예시
응답 예시 1 — 휴가 사용일 기준 조회
{
"message" : "OK",
"data" : {
"page" : {
"totalCount" : 86,
"currentPage" : 0,
"pageSize" : 50,
"totalPages" : 2
},
"elements" : [
{
"platformUserId" : "다우오피스 사용자 고유 식별자 ID 예)135612340000",
"loginId" : "다우오피스 사용자 계정 예)daou_sample",
"name" : "다우오피스 사용자 이름 예)김다우",
"employeeNumber" : null,
"leaveCategoryName" : "출산휴가",
"leaveCategoryCode" : "pregnant",
"leaveDate" : "2025-08-01",
"leaveStartTime" : null,
"leaveEndTime" :null,
"workReferenceDate" : "2025-08-01",
"usedLeaveDuration" : "08:00:00",
"docId" : "전자결재 내부 Primary Key 예)0012345678900",
"docNum" : "전자결재 문서번호 예)Sample부서-2025-00048",
"docDraftedAt" : "2025-07-11 17:12:46",
"docCompletedAt" : "2025-07-14 09:41:52",
"docStatusCode" : "APPROVAL",
"zoneId" : "Asia/Seoul",
"isAllDay" : true,
"isPaidLeave" : true
}
]
}
}
응답 예시 2 — 취소된 휴가 결재 조회 (docStatusCode=CANCEL)
docStatusCode가 CANCEL로 반환되고, docCompletedAt에는 결재 취소일시가 반환됩니다.
{
"message" : "OK",
"data" : {
"page" : {
"totalCount" : 3,
"currentPage" : 0,
"pageSize" : 50,
"totalPages" : 1
},
"elements" : [
{
"platformUserId" : "다우오피스 사용자 고유 식별자 ID 예)135612340000",
"loginId" : "다우오피스 사용자 계정 예)daou_sample",
"name" : "다우오피스 사용자 이름 예)김다우",
"employeeNumber" : null,
"leaveCategoryName" : "출산휴가",
"leaveCategoryCode" : "pregnant",
"leaveDate" : "2026-09-15",
"leaveStartTime" : null,
"leaveEndTime" : null,
"workReferenceDate" : "2026-09-15",
"usedLeaveDuration" : "08:00:00",
"docId" : "전자결재 내부 Primary Key 예)0012345678900",
"docNum" : "전자결재 문서번호 예)Sample부서-2026-00112",
"docDraftedAt" : "2026-09-01 10:12:46",
"docCompletedAt" : "2026-09-10 16:30:05",
"docStatusCode" : "CANCEL",
"zoneId" : "Asia/Seoul",
"isAllDay" : true,
"isPaidLeave" : true
}
]
}
}
🚫 주요 오류 코드 예시
| 코드 | 내용 |
설명(Description) |
|---|---|---|
| 400 | 유효하지 않은 파라미터, 필수 파라미터 누락 |
유효하지 않은 파라미터입니다. |
| 401 | 토큰 없음/유효하지 않음/만료됨 |
유효하지 않은 토큰입니다. 토큰이 존재하지 않습니다. 만료된 토큰입니다. |
| 500 | 일시적 서버 오류 |
일시적인 서비스 오류입니다. |
- Authorization 헤더가 없거나 "Bearer" 문자열이 누락·오표기된 경우, 서버는 401만 반환하고 본문을 포함하지 않을 수 있음.
- docStatusCode에 APPROVAL, CANCEL, RETURN 외의 값(소문자 포함)을 입력하면 400 "유효하지 않은 파라미터입니다."가 반환됩니다.