✅ 해당 기능이 제공되는 다우오피스 상품 유형
| 무료 | 서비스형 | 엔터프라이즈형 | HR형 | ||
|---|---|---|---|---|---|
| 스탠다드 | 스탠다드 | 프리미엄 | 스탠다드 | 프리미엄 | HR |
| ❌ | ❌ | ❌ | |||
부서원 정보 조회 API
다우오피스에 등록된 모든 부서의 소속 구성원(부서장 포함) 정보를 외부 시스템에서 한 번에 조회할 수 있는 API입니다. (ERP, HR 시스템에서 다우오피스 부서 구성 정보를 자동으로 불러올 때 사용)
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/member/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/member/list
(Body 없음)
(Query Parameter 없음)
(Body 없음)
(Query Parameter 없음)
📬Response Body
data 객체
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| code | int | ✅ | ⛔ | API 호출결과 코드 |
| message | String | ✅ | ⛔ | API 호출결과 메시지 |
| data | object | ✅ | ⛔ | 각 항목 코드, 타입, 정렬 순서 기준 등 |
data 객체 구조
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| loginId | String | ✅ | ⛔ | 로그인 아이디 |
| employeeNumber | String | ⛔ | ⛔ | 사번 |
| departmentCode | String | ✅ | ⛔ | 부서 코드 |
| dutyCode | String | ⛔ | ⛔ | 부서 직책 코드 |
| memberType | String | ⛔ | ⛔ |
멤버 타입
|
| sortOrder | String | ⛔ | ⛔ | 부서내 정렬순서 |
| departmentOrder | String | ✅ | ⛔ | 겸직부서 순서 |
📬Response 예시
json
{
"code" : "200",
"message" : "OK",
"data" : [
{
"loginId" : "로그인 아이디 예)daou_0123",
"employeeNumber" : null,
"departmentCode" : "부서 코드 예)development",
"dutycode" : "19",
"memberType" : "TEAM_MEMBER",
"sortOrder" : 4,
"departmentOrder" : 1,
},
{
"loginId" : "daou_1122",
"employeeNumber" : null,
"departmentCode" : "frontdevelop",
"dutycode" : "4",
"memberType" : "DEPARTMENT_HEAD",
"sortOrder" : 1,
"departmentOrder" : 1,
}
]
}
"message" : "OK",
"data" : [
{
"loginId" : "로그인 아이디 예)daou_0123",
"employeeNumber" : null,
"departmentCode" : "부서 코드 예)development",
"dutycode" : "19",
"memberType" : "TEAM_MEMBER",
"sortOrder" : 4,
"departmentOrder" : 1,
},
{
"loginId" : "daou_1122",
"employeeNumber" : null,
"departmentCode" : "frontdevelop",
"dutycode" : "4",
"memberType" : "DEPARTMENT_HEAD",
"sortOrder" : 1,
"departmentOrder" : 1,
}
]
}
🚫 주요 오류 코드 예시
| 코드 | 내용 | 설명(Description) |
|---|---|---|
| 400 | 유효하지 않은 파라미터, 필수 파라미터 누락 | 유효하지 않은 파라미터입니다. 필수 파라미터가 누락되었습니다. |
| 401 | 토큰 없음/유효하지 않음/만료됨 |
유효하지 않은 토큰입니다. 토큰이 존재하지 않습니다. 만료된 토큰입니다. |
| 500 | 일시적 서버 오류 | 일시적인 서비스 오류입니다. |
- Authorization 헤더가 없거나 "Bearer" 문자열이 누락·오표기된 경우, 서버는 401만 반환하고 본문을 포함하지 않을 수 있음.