모바일 결재 #1 - 본문 저장 – 다우오피스 고객케어라운지

개요

다우오피스 모바일 전자결재 기안 연동을 위한 <모바일 결재 #1 - 본문 저장 API 입니다. 모바일 전자결재 기안 API 연동을 위해서는 <모바일 결재 #1 - 본문 저장 API>와<모바일 결재 #2 – 기안 API>로 나누어집니다. #1, #2는 순차적으로 처리되어야 합니다.

Request URL

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

HTTP Method

POST (Content-Type: application/x-www-form-urlencoded; charset=UTF-8)

Request Parameters

변수 (Parameter)	타입(Type)	필수 여부	사전 발급	설명 (Description)
clientId	String	Y	Y	고객사 식별/인증을 위한 서비스 인증ID / Client ID ※ <인증키 발급 API>를 통해 전달받은 값
clientSecret	String	Y	Y	고객사 식별/인증을 위한 서비스 보안KEY / Secret Key ※ <인증키 발급 API>를 통해 전달받은 값
Title	String	Y	N	다우오피스 전자결재 제목
content	String	Y	N	다우오피스 전자결재 본문 HTML
productName	String	N	N	업무시스템 제품명(제휴시스템 사용할 경우 입력)
productVersion	String	N	N	업무시스템 제품버전(제휴시스템 사용할 경우 입력)
clientCompanyName	String	N	N	업무시스템 고객사 식별정보(제휴시스템 사용할 경우 입력)
allianceInfo	Object	N	N	전자결재 공유정보를 위한 Object[배열]

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

- allianceInfo (업무시스템에서 전달하고자 하는 배열값으로 필요 시에만 작성합니다.)

변수 (Parameter)	타입(Type)	필수 여부	사전 발급	설명 (Description)
key	String	Y	Y	변수(Parameter)
value	String	Y	N	각 변수(Parameter)의 내용(Value)

Request Example

POST /public/approval/content HTTP/1.1
api.daouoffice.com
Content-Type: application/x-www-form-urlencoded
{
    "clientId": "f255cbe0b4a9d12f",
    "clientSecret": "bafdd7b4cff6fabdc417b8a6b0e4fff6",
    "tilte": "모바일전자결재",
    "content": "<p>내용</p>",  ※ HTML 본문
    "productName" : "DSoft BIS",
    "productVersion" : "3.1.21",
    "clientCompanyName" : "ddgs11231#1122",
    "allianceInfo": [
         {내용생략} 
    ]
}

Response Parameters

변수 (Parameter)	타입 (Type)	필수 여부	사전 발급	설명 (Description)
code	String	Y	N	API 호출결과 코드
message	String	Y	N	API 호출결과 메시지
messageDetail	String	N	N	API 호출결과 메시지 상세내용 (실패한 경우만 리턴함)
data	Object	Y	N	API 호출결과 상세내용 Object 배열

- data

변수 (Parameter)	타입(Type)	필수 여부	사전 발급	설명 (Description)
contentId	String	Y	N	다우오피스 전자결재 본문(HTML)값 / 본문 고유 식별번호

Response Example

Content-Type: application/x-www-form-urlencoded; charset=UTF-8
{
    "code": "200",
    "message": "OK",
    "data": {
    "contentId": { "24115"},
    "invalidReceivers": { "U2456": "존재하지 않는 계정입니다.", "U2457": "중지된 계정입니다." }
    }
}

Return Code

구분	코드 (Code)	내용 (Message)	설명 (Description)
성공 (Success)	200	성공	OK
실패 (Error)	901	유효하지 않은 Client ID	'XXXX'는 유효하지 않은 연동ID(clientId) 입니다.
	902	유효하지 않은 Client Secret	연동 ID 'XXXX'의 패스워드가 일치하지 않습니다.
	970	유효하지 않은 데이터 포맷	유효하지 않은 데이터 포맷입니다.
	975	전자결재 문서(content) 데이터 저장오류가 발생되었습니다.	전자결재 본문 저장 중 에러가 발생했습니다.

제공 서비스 유형

구분	제공 여부
다우오피스 단독형	제공
다우오피스 설치형	제공
다우오피스 구축형	제공
다우오피스 공유형	미제공

모바일 결재 #1 - 본문 저장

개요