인증키 발급

개요

다우오피스 OpenAPI 서비스의 연동을 위한 <인증키 발급 API> 입니다. API를 통해서 발급되는 인증키 값(clientID, clientSecret)은 고객사 별로 1개만 발급되며 인증키는 타 고객사에 양도할 수 없습니다.

발급을 위한 정보는 다우오피스 접속URL, 관리자ID/PW이며 해당 정보는 고객사에서 관리하는 값입니다. 발급키는 삭제/재발급 전까지 고정적으로 유지되는 값입니다. 발급 API를 재호출할 경우 기존에 생성된 인증키 값을 리턴합니다.

다우오피스 서비스 정책상 DOAS(DaouOffice API System)에서 정기적으로 ClientSecret 값을 변경합니다. 때문에 clientID, clientSecret 값을 저장해서 사용하기보단 해당 값을 불러와 변수 처리하여 API 호출에 사용하기를 권장합니다. 또한 연동하는 시스템에서 해당 clientSecret 값을 같이 변경하지 않으면 오류가 발생될 수 있으므로 연동된 clientId, clientSecret 값을 저장하여 연동하는 것을 권장합니다

Request URL

https://api.daouoffice.com/public/v2/alliance/company
※ 다우오피스 OpenAPI 서비스는 DOAS 서버로 API 호출을 진행하기 때문에 별도 고객사 그룹웨어 URL이 아닌 “https://api.daouoffice.com”을 사용합니다.

HTTP Method

POST (Content-Type: application/json; charset=UTF-8)

Request Parameters

※ productName, productVersion, clientCompanyName은 외부업무시스템의 정보를 전달받아 문제 발생 시 다우기술에서 로그 확인을 위해 필요한 사항입니다. 필수 입력값은 아니므로 초기 개발 시 비워두고 정식 사용 시 값을 입력하는 것을 권장합니다.

- apiType (복수 지정 불가능)

- partnerCode

Request Example

POST /public/v2/alliance/company HTTP/1.1
api.daouoffice.com
Content-Type: application/json
{
    "siteUrl" : "partner.daouoffice.com",
    "adminId" : "admin@partner.daouoffice.com",
    "adminPw" : "password1234#",
    "partnerCode" : "OPENAPI_D",
    "apiType" : "ATTND",
    "productName" : "제휴서비스/제품 명",
    "productVersion" : "제휴서비스/제품 버전",
    "clientCompanyName" : "제휴서비스/제품 식별코드"
}

Response Parameters

- data

Response Example

Content-Type: application/json;charset=UTF-8
{
   "code": "200",
   "message": "OK",
   "data":{
          "clientId": "f255cbe0b4e1wgasf",
          "clientSecret": "bafdd7bf1e12esdc417b8a6b0e4fff6"
   }
}

Return Code

제공 서비스 유형