✅ 해당 기능이 제공되는 다우오피스 상품 유형

무료 서비스형 엔터프라이즈형
스탠다드 스탠다드 프리미엄 스탠다드 프리미엄
❌ ❌ ❌ ✅ ✅

👉🏼 유형별 제품 안내 보기 

 

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
기준 날짜는 docStatusCode 값에 따라 달라집니다.

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건씩 조회합니다.

GET https://api.daouoffice.com/public/api/attnd-v2/vacation?startDate=2025-09-01&endDate=2025-09-30&page=0&pageSize=50
Authorization :  Bearer {ACCESS_TOKEN}

 

요청 예시 2 — 취소된 휴가 결재 조회

2026년 9월 한 달 동안 취소된 휴가 결재를 조회합니다.

GET https://api.daouoffice.com/public/api/attnd-v2/vacation?startDate=2026-09-01&endDate=2026-09-30&docStatusCode=CANCEL
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를 CANCEL로 요청하면 취소 시점, RETURN으로 요청하면 반려 시점이 반환됩니다.

docStatusCode

String ✅ ⛔  

전자결재 상태
docStatusCode 없이 요청하면 INPROGRESS(진행 중) 또는 APPROVAL(승인)이 반환됩니다. docStatusCode를 입력해 요청하면 요청한 값과 같은 값이 반환되며, 강제반려된 결재도 RETURN으로 반환됩니다.

zoneId

String ✅ ⛔  

근무그룹 타임존 (서머타임 미적용 타임존)

 

 

 

📬Response 예시

응답 예시 1 — 휴가 사용일 기준 조회


{

"code" : "200",
"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에는 결재 취소일시가 반환됩니다.


{

"code" : "200",
"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 "유효하지 않은 파라미터입니다."가 반환됩니다.

원하는 답을 찾지 못하셨나요?

스피키에게 물어보기

궁금한 기능이나 사용 방법을 AI 챗봇이 바로 알려 드립니다.

경로화면 오른쪽 아래 스피키 아이콘 선택

1:1 문의 등록하기 관리자

오류·장애 등 기술 지원은 관리자 계정으로 요청해 주세요.

경로화면 오른쪽 위 [문의등록] 선택