대행사 수신서버 URL

Request

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

post

https://api-qa.rcsbizcenter.com/api/1.1https://api.rcsbizcenter.com/api/1.1

/{webhookUrl}

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

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

• 브랜드 수정/반려

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

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

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

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

• 대행사 키 재발급

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

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

Authorizations

jwtAuth

AuthorizationstringRequired

인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.

Path parameters

webhookUrlstringRequired

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

Body

application/json

or

or

or

or

or

or

or

or

or

Responses

200

페이지 내 Response 섹션 참조

No content

post

/{webhookUrl}

HTTPcURLJavaScriptPython

POST /api/1.1/{webhookUrl} HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer YOUR_SECRET_TOKEN
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"
}

대화방

템플릿양식

템플릿

포멧

브랜드

자동응답

대행사키

레이아웃

로고

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

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