부서 정보 조회

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

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

👉🏼 유형별 제품 안내 보기

부서 정보 조회 API

다우오피스 부서 정보 조회 API는 외부 시스템에서 회사에 등록된 모든 임직원의 부서 정보를 한 번에 불러올 수 있는 기능입니다.

Access Token 발행 API (공통 선행)

모든 OpenAPI 호출 전 반드시 Access Token을 먼저 발급받아야 합니다. 발급받은 Token은 이후 모든 API 호출의 Request Header에 포함됩니다.

📑Access Token 발행 API 상세 가이드

✔️ Request URL

https://api.daouoffice.com/public/api/attnd-v3/organization-chart/department/list

다우오피스 OpenAPI 서비스는 시스템연동 서버로 API 호출을 진행하기 때문에 별도 고객사 그룹웨어 URL이 아닌 https://api.daouoffice.com 사용

✉️ Request Body

해당 API는 요청 시 별도의 Query Parameter를 요구하지 않습니다.

Headers

변수

타입

필수

사전발급

설명

Authorization

String

✅

Authorization: Bearer {ACCESS_TOKEN}

반드시 헤더에 포함. “Bearer” 뒤 공백 1칸 필수

✉️ Request 예시

GET https://api.daouoffice.com/public/api/attnd-v3/organization-chart/department/list
(Body 없음)
(Query Parameter 없음)

📬Response Body

data 객체

변수	타입	필수	사전발급	설명
code	int	✅	⛔	API 호출결과 코드
message	String	✅	⛔	API 호출결과 메시지
data	object	✅	⛔	각 항목 코드, 타입, 정렬 순서 기준 등

data 객체 구조

변수	타입	필수	사전발급	설명
name	String	✅	⛔	부서 이름
parentCode	String	⛔	⛔	상위 부서 코드
sortOrder	String	✅	⛔	정렬 순서
code	String	⛔	⛔	부서 코드
alias	String	⛔	⛔	부서 약어
emailId	String	⛔	⛔	부서 이메일
autoSort	String	✅	⛔	자동 정렬 사용여부

multi Language Name

변수	타입	필수	사전발급	설명
koName	String	⛔	⛔	한국어
enName	String	⛔	⛔	영문
jpName	String	⛔	⛔	일본어
zhcnName	String	⛔	⛔	중국어(번체)
zhtwName	String	⛔	⛔	중국어(간체)
viName	String	⛔	⛔	베트남어

📬Response 예시

json

{

"code" : "200",
"message" : "OK",
"data" : [
{
"name" : "부서 이름 예)개발팀",
"parentCode" : null,
"sortOrder" : "1",
"code" : "부서코드 예)development",
"alias" : null,
"email" : "부서 이메일 예)development@sample.com",
"autoSort" : true,
"multiLanguageName" : {
   "koName" : "개발팀",
   "enName" : null,
   "jpName" : null,
   "zhcnName" : null,
   "zhtwName" : null,
   "viName" : null
   }
},
{
"name" : "프론트개발팀",
"parentCode" : "상위 부서 코드 예)development",
"sortOrder" : "1",
"code" : "부서코드 예)frontdevelop",
"alias" : null,
"email" : null,
"autoSort" : true,
"multiLanguageName" : {
   "koName" : "프론트개발팀",
   "enName" : null,
   "jpName" : null,
   "zhcnName" : null,
   "zhtwName" : null,
   "viName" : null
}
}
   ]
}

🚫 주요 오류 코드 예시

코드

내용

설명(Description)

400

유효하지 않은 파라미터, 필수 파라미터 누락

유효하지 않은 파라미터입니다.
필수 파라미터가 누락되었습니다.

401

토큰 없음/유효하지 않음/만료됨

유효하지 않은 토큰입니다.

토큰이 존재하지 않습니다.

만료된 토큰입니다.

500

일시적 서버 오류

일시적인 서비스 오류입니다.

Authorization 헤더가 없거나 "Bearer" 문자열이 누락·오표기된 경우, 서버는 401만 반환하고 본문을 포함하지 않을 수 있음.