1 of 1

대행사 브랜드 목록 조회

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드와 대행사의 계약관계 정보입니다.

code

string

20000000

status

integer

200

desc

string

object

전체 건수와 페이징 조건을 제공합니다.

object

이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

corpId

string

RCS Biz Center에 등록된 기업 ID 입니다.

corpRegNum

string

RCS Biz Center에 등록된 기업의 사업자등록번호 입니다.

brandId

string

브랜드 ID 입니다.

brandName

string

브랜드 명 입니다.

agencyId

string

대행사 ID 입니다

array<string>

계약 유형 입니다

a2p
chat

registerDate

string

계약정보 등록일시 입니다.

updateDate

string

계약정보 수정일시 입니다.

brandDate

string

계약된 대상 브랜드의 최종 변경 일시 정보 입니다.

chatbotDate

string

브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.

messagebaseDate

string

브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.

logoDate

string

브랜드 내 등록된 브랜드 로고 중 가장 최근에 변경된 로고의 일시 정보 입니다.

`contracts` - array<string>

필드명

타입

길이

필수여부

기본값

설명

Allowed

string

계약 유형 입니다.

a2p
chat

pagination - object

필드명

타입

길이

필수여부

기본값

설명

total

integer

전체건수

offset

integer

조회 기준 위치

limit

integer

페이지 당 조회 건수

links - object

필드명

타입

길이

필수여부

기본값

설명

prev

string

이전페이지URL

next

string

다음페이지URL

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpId": "CO.l9ZohLN20I",
            "corpRegNum": "3148158360",
            "brandId": "BR.i3gC1762pT",
            "brandName": "테스트브랜드",
            "status": "검수완료(수정)",
            "agencyId": "hong",
            "contracts": [
                "a2p,chat"
            ],
            "registerDate": "2024-06-10T16:39:14.000+09",
            "updateDate": "2024-06-10T16:39:14.000+09",
            "brandDate": "2024-06-05T15:27:19.000+09",
            "chatbotDate": "2024-06-05T15:27:17.000+09",
            "messagebaseDate": "2024-06-05T15:27:21.000+09",
            "logoDate": null,
            "approvalDate": "2024-06-10T10:16:59.000+09"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}

{agencyId}에 브랜드가 할당되지 않은 경우에는 빈 contents가 리턴될 수 있음.

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}

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

대행사 브랜드 목록 조회

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드와 대행사의 계약관계 정보입니다.

code

string

20000000

status

integer

200

desc

string

object

전체 건수와 페이징 조건을 제공합니다.

object

이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

corpId

string

RCS Biz Center에 등록된 기업 ID 입니다.

corpRegNum

string

RCS Biz Center에 등록된 기업의 사업자등록번호 입니다.

brandId

string

브랜드 ID 입니다.

brandName

string

브랜드 명 입니다.

agencyId

string

대행사 ID 입니다

array<string>

계약 유형 입니다

a2p
chat

registerDate

string

계약정보 등록일시 입니다.

updateDate

string

계약정보 수정일시 입니다.

brandDate

string

계약된 대상 브랜드의 최종 변경 일시 정보 입니다.

chatbotDate

string

브랜드 내 등록된 대화방 중 가장 최근에 변경된 대화방의 일시 정보 입니다.

messagebaseDate

string

브랜드 내 등록된 템플릿 중 가장 최근에 변경된 템플릿의 일시 정보 입니다.

logoDate

string

브랜드 내 등록된 브랜드 로고 중 가장 최근에 변경된 로고의 일시 정보 입니다.

`contracts` - array<string>

필드명

타입

길이

필수여부

기본값

설명

Allowed

string

계약 유형 입니다.

a2p
chat

pagination - object

필드명

타입

길이

필수여부

기본값

설명

total

integer

전체건수

offset

integer

조회 기준 위치

limit

integer

페이지 당 조회 건수

links - object

필드명

타입

길이

필수여부

기본값

설명

prev

string

이전페이지URL

next

string

다음페이지URL

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "corpId": "CO.l9ZohLN20I",
            "corpRegNum": "3148158360",
            "brandId": "BR.i3gC1762pT",
            "brandName": "테스트브랜드",
            "status": "검수완료(수정)",
            "agencyId": "hong",
            "contracts": [
                "a2p,chat"
            ],
            "registerDate": "2024-06-10T16:39:14.000+09",
            "updateDate": "2024-06-10T16:39:14.000+09",
            "brandDate": "2024-06-05T15:27:19.000+09",
            "chatbotDate": "2024-06-05T15:27:17.000+09",
            "messagebaseDate": "2024-06-05T15:27:21.000+09",
            "logoDate": null,
            "approvalDate": "2024-06-10T10:16:59.000+09"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}

{agencyId}에 브랜드가 할당되지 않은 경우에는 빈 contents가 리턴될 수 있음.

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

{
    "error": {
        "code": "61005",
        "message": "Invalid client id"
    },
    "status": 401
}

{
    "error": {
        "code": "61007",
        "message": "not allowed IP. unregistered 0.0.0.0"
    },
    "status": 401
}

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

대행사 브랜드 목록 조회

Request

Response

result - array<object>

contracts - array<string>

pagination - object

links - object

❖ response body sample

대행사 브랜드 목록 조회

Request

Response

result - array<object>

contracts - array<string>

pagination - object

links - object

❖ response body sample

대행사가 계약된 브랜드 리스트를 제공합니다.

`contracts` - array<string>

`contracts` - array<string>