✅ 해당 기능이 제공되는 다우오피스 상품 유형
| 무료 | 서비스형 | 엔터프라이즈형 | HR형 | ||
|---|---|---|---|---|---|
| 스탠다드 | 스탠다드 | 프리미엄 | 스탠다드 | 프리미엄 | HR |
| ❌ | ❌ | ❌ | |||
다우오피스 OpenAPI를 연동하기 위해 필수인 인증키(Client ID / Client Secret) 의 발급, 조회, 재발급 절차를 통합 정리한 가이드입니다.
인증키 재발급 API
보안 이슈나 clientSecret 변경 필요 시, 기존 인증키를 재발급하는 API입니다.
✔️ Request URL
https://api.daouoffice.com/public/v1/alliance/reissue
다우오피스 OpenAPI 서비스는 시스템연동 서버로 API 호출을 진행하기 때문에 별도 고객사 그룹웨어 URL이 아닌 https://api.daouoffice.com 사용
✔️ HTTP Method
POST (Content-Type: application/json; charset=UTF-8)
✉️ Request Body
| 변수 | 타입 | 필수 | 사전발급 | 설명 |
|---|---|---|---|---|
| siteUrl | String | ✅ | ✅ |
고객사 다우오피스 접속 URL 예) abc.daouoffice.com |
| clientId | String | ✅ | ✅ | 고객사 식별/인증을 위한 서비스 인증ID / Client ID |
| adminId | String | ✅ | ✅ | 다우오피스 최고 관리자 계정 (이메일 형식) |
| adminPw | String | ✅ | ✅ | 최고 관리자 비밀번호 |
| productName | String | ⛔ | ⛔ | 제휴 제품명 |
| productVersion | String | ⛔ | ⛔ | 제품 버전 정보 |
| clientCompanyName | String | ⛔ | ⛔ | 제휴사 고객사 식별 정보 |
- productName, productVersion, clientCompanyName은 외부 시스템의 정보로, API 호출 시 문제 발생 시 로그 분석을 위한 참고용 항목이나 개발 초기에는 생략해도 되지만, 정식 연동 시에는 입력해주는 것이 좋습니다.
- ⛔ 선택값은 테스트 시 생략 가능하나, 운영 단계에서는 입력을 권장합니다.
✉️ Request 예시
POST /public/v1/alliance/reissue HTTP/1.1
api.daouoffice.com
Content-Type: application/json
{
"clientId" : "고객사식별인증Id(xxxxxxxxxx)",
"adminId" : "다우오피스최고관리자계정(admin@partner.daouoffice.com)",
"adminPw" : "최고관리자비밀번호(xxxxxxxxxx)",
"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) |
|---|---|---|
| 901 | 유효하지 않은 client ID | client ID를 확인하세요. |
| 910 | 유효하지 않은 파라미터 | 도메인을 포함한 이메일 형식이여야 합니다. |
| 911 | 계정 형식 오류 | 도메인을 포함한 이메일 형식이여야 합니다. |
| 951 | 존재하지 않은 계정 | oooo는 존재하지 않은 계정입니다. |
| 999 | 유효하지 않는 라이선스 | 발급받은 라이선스를 확인하세요. |