✅ 해당 기능이 제공되는 다우오피스 상품 유형
| 무료 | 서비스형 | 엔터프라이즈형 | HR형 | ||
|---|---|---|---|---|---|
| 스탠다드 | 스탠다드 | 프리미엄 | 스탠다드 | 프리미엄 | HR |
| ❌ | ❌ | ❌ | |||
다우오피스 OpenAPI를 연동하기 위해 필수인 인증키(Client ID / Client Secret) 의 발급, 조회, 재발급 절차를 통합 정리한 가이드입니다.
인증키 조회
이미 발급된 인증키(clientId, clientSecret)를 다시 확인하고자 할 때 사용합니다.
✔️ Request URL
https://api.daouoffice.com/public/v1/alliance/key
다우오피스 OpenAPI 서비스는 시스템연동 서버로 API 호출을 진행하기 때문에 별도 고객사 그룹웨어 URL이 아닌 https://api.daouoffice.com 사용
✔️ HTTP Method
POST (Content-Type: application/json; charset=UTF-8)
✉️ Request Body
발급 API와 거의 동일한 파라미터를 사용하지만, apiType 없이도 조회 가능
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| siteUrl | String | ✅ | ✅ |
고객사 다우오피스 접속 URL 예) abc.daouoffice.com |
| adminId | String | ✅ | ✅ | 다우오피스 최고 관리자 계정 (이메일 형식) |
| adminPw | String | ✅ | ✅ | 최고 관리자 비밀번호 |
| apiType | String | ✅ | ⛔ | 연동할 API 타입 (전자결재, 근태 등 - 아래 표 참고) |
| partnerCode | String | ✅ | ✅ | 제휴 시스템 코드 (예: OPENAPI_D) |
| productName | String | ⛔ | ⛔ | 제휴 제품명 |
| productVersion | String | ⛔ | ⛔ | 제품 버전 정보 |
| clientCompanyName | String | ⛔ | ⛔ | 제휴사 고객사 식별 정보 |
partnerCode 목록
| 값 | 제휴 시스템 |
|---|---|
| OPENAPI_D | 공개 API용 기본 코드 |
| BIZPLAY | 비즈플레이 / 지출결의 |
| KSYSTEM | 영림원 소프트랩 |
| ADTCAPS | ADT캡스 / 출입통제 시스템 |
| TELECOP | KT텔레갑 / 출입통제 시스템 |
| SECOM | 에스원 세콤 / 출입통제 시스템 |
✉️ Request 예시
POST /public/v1/alliance/Key HTTP/1.1
api.daouoffice.com
Content-Type: application/json
{
"adminId" : "다우오피스최고관리자계정(admin@partner.daouoffice.com)",
"adminPw" : "최고관리자비밀번호(xxxxxxxxxx)",
"apiType" : "연동API타입(ATTND)",
"partnerCode" : "제휴시스템코드(OPENAPI_D)",
"productName" : "제휴서비스명",
"productVersion" : "제휴서비스 제품 버전",
"clientCompanyName" : "제휴고객사식별정보(partner-client-001)"
}
📬 Response Body
data 객체
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| code | String | ✅ | ⛔ | API 호출 결과 코드 (200, 951, 등) |
| message | String | ✅ | ⛔ | 호출 결과 메시지 (OK, 존재하지 않는 계정, 등) |
| messageDetail | String | ⛔ | ⛔ | 실패 시 상세 설명 |
| data | Object | ✅ | ⛔ | 인증키 발급 결과 정보 |
data 객체 구조
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| clientId | String | ✅ | ✅ | 발급된 인증 ID (DaouOffice API 연동용 식별자) |
| clientSecret | String | ✅ | ⛔ | 발급된 보안키 (Secret Key, 보안상 외부 저장은 권장하지 않음) |
📬 Response 예시
Content-Type: application/json;charset=UTF-8
{
"message" : "OK",
"data" : {
"clientId" :"(서비스인증ID)xxxxxxxxxx",
"clientSecret":"(서비스보안Key)xxxxxxxxxx",
}
}
🚫 에러 코드 주요 예시
| 코드 | 내용 | 설명(Description) |
|---|---|---|
| 910 | 유효하지 않은 파라미터 | 도메인을 포함한 이메일 형식이여야 합니다. |
| 911 | 계정 형식 오류 | 도메인을 포함한 이메일 형식이여야 합니다. |
| 912 | 유효하지 않은 파트너 코드 | 유효하지 않은 파트너 코드입니다. |
| 951 | 존재하지 않은 계정 | oooo는 존재하지 않은 계정입니다. |
| 952 | 패스워드 누락 | 패스워드(adminPw)가 누락되었습니다. |
| 953 | 패스워드 불일치 | 계정 oooo의 패스워드가 일치하지 않습니다. |
| 954 | 계정 권한 오류 | 계정 oooo는 관리자 권한이 없는 계정입니다. |
| 955 | 도메인 코드 오류 | oooo는 존재하지 않는 도메인 코드입니다. |