✅ 해당 기능이 제공되는 다우오피스 상품 유형
| 무료 | 서비스형 | 엔터프라이즈형 | HR형 | ||
|---|---|---|---|---|---|
| 스탠다드 | 스탠다드 | 프리미엄 | 스탠다드 | 프리미엄 | HR |
| ❌ | ❌ | ❌ | |||
계정 부가 정보 조회 API
다우오피스 OpenAPI 서비스의 조직 부가 정보 조회 연동을 위한 <계정 부가 정보 조회 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/domain-code/position/list
- 직급 : https://api.daouoffice.com/public/api/attnd-v3/organization-chart/domain-code/grade/list
- 직책 : https://api.daouoffice.com/public/api/attnd-v3/organization-chart/domain-code/duty/list
-
사용자 그룹 : https://api.daouoffice.com/public/api/attnd-v3/organization-chart/domain-code/user_group/list
다우오피스 OpenAPI 서비스는 시스템연동 서버로 API 호출을 진행하기 때문에 별도 고객사 그룹웨어 URL이 아닌 https://api.daouoffice.com 사용
✉️ Request Body
GET이므로 쿼리 파라미터와 헤더로 구성됩니다.
Headers
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| Authorization | String | ✅ | ✅ |
Authorization: Bearer {ACCESS_TOKEN} 반드시 헤더에 포함. “Bearer” 뒤 공백 1칸 필수 |
Parameters
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| codeType | String | ✅ | ⛔ |
|
✉️ Request 예시
GET https://api.daouoffice.com/public/api/attnd-v3/organization-chart/domain-code/grade/list
Authorization : Bearer {ACCESS_TOKEN}
Authorization : Bearer {ACCESS_TOKEN}
📬Response Body
data 객체
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| code | int | ✅ | ⛔ | API 호출결과 코드 |
| message | String | ✅ | ⛔ | API 호출결과 메시지 |
| data | object | ✅ | ⛔ | 각 항목 코드, 타입, 정렬 순서 기준 등 |
data 객체 구조
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| code | String | ⛔ | ⛔ | 각 항목의 코드 |
| type | String | ✅ | ⛔ | 조회하는 도메인의 클래스 타입 |
| name | String | ✅ | ⛔ | 조회하는 클래스 타입 이름 |
| sortOrder | String | ✅ | ⛔ | 정렬 순서 기준 |
multi Language Name
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| koName | String | ⛔ | ⛔ | 한국어 |
| enName | String | ⛔ | ⛔ | 영문 |
| jpName | String | ⛔ | ⛔ | 일본어 |
| zhcnName | String | ⛔ | ⛔ | 중국어(번체) |
| zhtwName | String | ⛔ | ⛔ | 중국어(간체) |
| viName | String | ⛔ | ⛔ | 베트남어 |
📬Response 예시
json
{
{
"code" : "200",
"message" : "OK",
"data" : [
{
"code" : "GSMB4",
"type" : "GRADE",
"name" : "책임4",
"sortOrder" : "1",
"multiLanguageName" : {
"koName" : "책임4",
"enName" : null,
"jpName" : null,
"zhcnName" : null,
"zhtwName" : null,
"viName" : null
}
},
{
"code" : "GSMB3",
"type" : "GRADE",
"name" : "책임3",
"sortOrder" : "2",
"multiLanguageName" : {
"koName" : "책임3",
"enName" : null,
"jpName" : null,
"zhcnName" : null,
"zhtwName" : null,
"viName" : null
}
}
]
}
"message" : "OK",
"data" : [
{
"code" : "GSMB4",
"type" : "GRADE",
"name" : "책임4",
"sortOrder" : "1",
"multiLanguageName" : {
"koName" : "책임4",
"enName" : null,
"jpName" : null,
"zhcnName" : null,
"zhtwName" : null,
"viName" : null
}
},
{
"code" : "GSMB3",
"type" : "GRADE",
"name" : "책임3",
"sortOrder" : "2",
"multiLanguageName" : {
"koName" : "책임3",
"enName" : null,
"jpName" : null,
"zhcnName" : null,
"zhtwName" : null,
"viName" : null
}
}
]
}
🚫 주요 오류 코드 예시
| 코드 | 내용 | 설명(Description) |
|---|---|---|
| 400 | 유효하지 않은 파라미터, 필수 파라미터 누락 | 유효하지 않은 파라미터입니다. 필수 파라미터가 누락되었습니다. |
| 401 | 토큰 없음/유효하지 않음/만료됨 |
유효하지 않은 토큰입니다. 토큰이 존재하지 않습니다. 만료된 토큰입니다. |
| 500 | 일시적 서버 오류 | 일시적인 서비스 오류입니다. |
- Authorization 헤더가 없거나 "Bearer" 문자열이 누락·오표기된 경우, 서버는 401만 반환하고 본문을 포함하지 않을 수 있음.