알림 발송

개요

다우오피스 알림(m-push, WEB&Messenger 알림, e-mail 알림) 연동을 위한 <알림 발송 API>입니다. 알림 수신자는 다우오피스의 사원번호(employeeNumber) 기준으로 연동됩니다. 조직 정보 조회 연동을 선행하거나, 사원번호를 등록하여 활용해야 합니다.

Request URL

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

HTTP Method

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

Request Parameters

① OpenAPI를 사용하여 알림 발송 시, 메시지 접두어로 [OpenAPI] 텍스트가 포함된 알림으로 발송됩니다. 시스템 알림 구분하기 위한 값으로 접두어 [OpenAPI] 문구 변경/삭제 불가합니다.

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

Request Example

POST /public/v1/noti HTTP/1.1
api.daouoffice.com
Content-Type: application/json
{
   "clientId": "f255cbe0b4a9d12f",
   "clientSecret": "bafdd7b4cff6fabdc417b8a6b0e4fff6",
   "productName" : "제휴서비스/제품 명",
   "productVersion" : "제휴서비스/제품 버전",
   "clientCompanyName" : "제휴서비스/제품 식별번호",
   "sender":"U1001",
   "receivers":["U2034","U2345","U2456","U2456"],
   "mailTitle":"업무가 도착하였습니다.",
   "mailMessage":"업무가 도착하였습니다.",
   "message":"중요한 업무가 도착했습니다. 빠른 처리 부탁드립니다.",
   "linkUrl":"https://daouoffice.com/app/board"
}

Response Parameters

- data

- validReceivers

- invalidReceivers

Response Example

Content-Type: application/json;charset=UTF-8
{
   "code": "200",
   "message": "OK",
   "data": {
      "validReceivers": { "U2034": "성공", "U2345": "성공"},
      "invalidReceivers": { "U2456": "존재하지 않는 계정입니다.", "U2457": "중지된 계정입니다." }
   }
}

Return Code

제약 사항

제공 서비스 유형