대행사 수신서버 URL

Request

대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다.

post

대행사에서 등록한 수신서버 URL을 통해 RBC에서 발생하는 데이터의 등록/수정/삭제 이벤트 정보를 전달합니다. 등록/수정/삭제 알림 대상은 다음과 같습니다.

• 브랜드 계약(권한) 등록

• 브랜드 수정/반려

• 대화방 승인/수정/반려/삭제

• 템플릿 승인/수정/반려/삭제

• 자동응답메시지 등록/수정/삭제

• 신규 포멧/템플릿 상품 등록

• 대행사 키 재발급

• 레아아웃 등록/수정/삭제

• 로고 승인/수정/반려/삭제

Authorizations

jwtAuth

Path parameters

webhookUrlstringRequired

RBC에 등록된 대행사 계정 정보 상에 대행사가 직접 등록한 수신서버(Webhook) URL 정보입니다.

Body

application/json

one ofOptional

or

or

or

or

or

or

or

or

or

Responses

200

페이지 내 Response 섹션 참조

No content

post

HTTPcURLJavaScriptPython

POST /api/1.1/{webhookUrl} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "notiType": "contract",
  "corpId": "text",
  "corpRegNum": "text",
  "brandId": "text",
  "method": "rejected",
  "reason": "text"
}

200

페이지 내 Response 섹션 참조

No content

❖ request body sample

브랜드계약

{
      "notiType": "contract",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

대화방

{
      "notiType": "chatbot",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

템플릿양식

{
      "notiType": "messagebaseform",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

템플릿

{
      "notiType": "template",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

포멧

{
      "notiType": "format",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

브랜드

{
      "notiType": "brand",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

자동응답

{
      "notiType": "autoreplymsg",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

대행사키

{
      "notiType": "agencykey",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

레이아웃

{
      "notiType": "formatbr",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

로고

{
      "notiType": "logo",
      "method": "created",
      "reason": ""
      "corpId": "CO.l9ZohLN20I",
      "corpRegNum": 3148158360
      "brandId": "BR.i3gC1762pT"
}

Response

필드명	타입	길이	필수여부	기본값	설명
status	string		O		200 : 성공적으로 알림을 수신하였을 경우 응답합니다. 400 : 대행사 측 청약이 우선 처리되지 않은 상태에서 'contract'가 전달된 경우 필히 응답되어야 합니다.
error	object

error - object

필드명	타입	길이	필수여부	기본값	설명
code	string
message	string

❖ response body sample

200

{
  "status": "200",
  "error": {
    "code": "",
    "message": ""
  }
}

400

{
  "status": "400",
  "error": {
    "code": "69999",
    "message": "No Subscription"
  }
}

error code는 RCS Biz Center - Response body error code 참조