1 of 15

브랜드

이 문서는 브랜드에 대한 API 정보를 안내합니다.

브랜드 카테고리 목록 조회

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드 카테고리 정보 객체입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

categoryId

string

브랜드 카테고리 ID 입니다.

categoryName

string

브랜드 카테고리 명 입니다.

array<object>

하위 카테고리 목록 입니다.

updateDate

string

수정일시 - 카테고리 수정 일시 입니다.

subCategories - array<object>

필드명

타입

길이

필수여부

기본값

설명

subCategoryId

string

브랜드 카테고리 ID 입니다.

subCategoryName

string

브랜드 카테고리 명 입니다.

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "updateDate": "2019-11-14T10:28:38.000+09",
            "categoryName": "IT",
            "categoryId": "ITE",
            "subCategories": [
                {
                    "subCategoryId": "ITE001",
                    "subCategoryName": "인터넷/컴퓨터"
                },
                {
                    "subCategoryId": "ITE002",
                    "subCategoryName": "정보통신/SW"
                },
                {
                    "subCategoryId": "ITE003",
                    "subCategoryName": "IT 정보"
                },
                {
                    "subCategoryId": "ITE004",
                    "subCategoryName": "전자/영상/음향"
                },
                {
                    "subCategoryId": "ITE005",
                    "subCategoryName": "IT 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:31.000+09",
            "categoryName": "교육",
            "categoryId": "EDU",
            "subCategories": [
                {
                    "subCategoryId": "EDU001",
                    "subCategoryName": "어린이집/유치원"
                },
                {
                    "subCategoryId": "EDU002",
                    "subCategoryName": "초중고등학교"
                },
                {
                    "subCategoryId": "EDU003",
                    "subCategoryName": "대학교/대학원"
                },
                {
                    "subCategoryId": "EDU004",
                    "subCategoryName": "학원"
                },
                {
                    "subCategoryId": "EDU005",
                    "subCategoryName": "온라인교육"
                },
                {
                    "subCategoryId": "EDU006",
                    "subCategoryName": "교육정보"
                },
                {
                    "subCategoryId": "EDU007",
                    "subCategoryName": "유학/연수"
                },
                {
                    "subCategoryId": "EDU008",
                    "subCategoryName": "시험/자격증"
                },
                {
                    "subCategoryId": "EDU009",
                    "subCategoryName": "교육 시설"
                },
                {
                    "subCategoryId": "EDU010",
                    "subCategoryName": "교육 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:31.000+09",
            "categoryName": "식품",
            "categoryId": "FOD",
            "subCategories": [
                {
                    "subCategoryId": "FOD001",
                    "subCategoryName": "음식점"
                },
                {
                    "subCategoryId": "FOD002",
                    "subCategoryName": "주류/음료"
                },
                {
                    "subCategoryId": "FOD003",
                    "subCategoryName": "농축수산물"
                },
                {
                    "subCategoryId": "FOD004",
                    "subCategoryName": "주점"
                },
                {
                    "subCategoryId": "FOD005",
                    "subCategoryName": "카페"
                },
                {
                    "subCategoryId": "FOD006",
                    "subCategoryName": "떡/제과"
                },
                {
                    "subCategoryId": "FOD007",
                    "subCategoryName": "외식/식음료 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:32.000+09",
            "categoryName": "병원",
            "categoryId": "HOS",
            "subCategories": [
                {
                    "subCategoryId": "HOS001",
                    "subCategoryName": "종합병원"
                },
                {
                    "subCategoryId": "HOS002",
                    "subCategoryName": "성형외과"
                },
                {
                    "subCategoryId": "HOS003",
                    "subCategoryName": "안과"
                },
                {
                    "subCategoryId": "HOS004",
                    "subCategoryName": "피부과"
                },
                {
                    "subCategoryId": "HOS005",
                    "subCategoryName": "치과"
                },
                {
                    "subCategoryId": "HOS006",
                    "subCategoryName": "산부인과"
                },
                {
                    "subCategoryId": "HOS007",
                    "subCategoryName": "한의원"
                },
                {
                    "subCategoryId": "HOS008",
                    "subCategoryName": "보건소"
                },
                {
                    "subCategoryId": "HOS009",
                    "subCategoryName": "내과"
                },
                {
                    "subCategoryId": "HOS010",
                    "subCategoryName": "외과"
                },
                {
                    "subCategoryId": "HOS011",
                    "subCategoryName": "이비인후과"
                },
                {
                    "subCategoryId": "HOS012",
                    "subCategoryName": "정형외과"
                },
                {
                    "subCategoryId": "HOS013",
                    "subCategoryName": "소아청소년과"
                },
                {
                    "subCategoryId": "HOS014",
                    "subCategoryName": "영상의학과 "
                },
                {
                    "subCategoryId": "HOS015",
                    "subCategoryName": "정신건강의학과"
                },
                {
                    "subCategoryId": "HOS016",
                    "subCategoryName": "마취통증의학과"
                },
                {
                    "subCategoryId": "HOS017",
                    "subCategoryName": "재활의학과"
                },
                {
                    "subCategoryId": "HOS018",
                    "subCategoryName": "한방병원"
                },
                {
                    "subCategoryId": "HOS019",
                    "subCategoryName": "흉부외과"
                },
                {
                    "subCategoryId": "HOS020",
                    "subCategoryName": "항문외과"
                },
                {
                    "subCategoryId": "HOS021",
                    "subCategoryName": "신경외과"
                },
                {
                    "subCategoryId": "HOS022",
                    "subCategoryName": "영상의학과 "
                },
                {
                    "subCategoryId": "HOS023",
                    "subCategoryName": "약국"
                },
                {
                    "subCategoryId": "HOS024",
                    "subCategoryName": "의료기구"
                },
                {
                    "subCategoryId": "HOS025",
                    "subCategoryName": "신경과"
                },
                {
                    "subCategoryId": "HOS026",
                    "subCategoryName": "검진센터"
                },
                {
                    "subCategoryId": "HOS027",
                    "subCategoryName": "병원 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:32.000+09",
            "categoryName": "쇼핑",
            "categoryId": "SHO",
            "subCategories": [
                {
                    "subCategoryId": "SHO001",
                    "subCategoryName": "의류"
                },
                {
                    "subCategoryId": "SHO002",
                    "subCategoryName": "가전/가구"
                },
                {
                    "subCategoryId": "SHO003",
                    "subCategoryName": "생활용품"
                },
                {
                    "subCategoryId": "SHO004",
                    "subCategoryName": "유아동"
                },
                {
                    "subCategoryId": "SHO005",
                    "subCategoryName": "자동차용품"
                },
                {
                    "subCategoryId": "SHO006",
                    "subCategoryName": "종합몰/마트/백화점"
                },
                {
                    "subCategoryId": "SHO007",
                    "subCategoryName": "오프라인 쇼핑"
                },
                {
                    "subCategoryId": "SHO008",
                    "subCategoryName": "해외쇼핑"
                },
                {
                    "subCategoryId": "SHO009",
                    "subCategoryName": "공동구매"
                },
                {
                    "subCategoryId": "SHO010",
                    "subCategoryName": "주문/배달/방문"
                },
                {
                    "subCategoryId": "SHO011",
                    "subCategoryName": "중고거래"
                },
                {
                    "subCategoryId": "SHO012",
                    "subCategoryName": "패션잡화"
                },
                {
                    "subCategoryId": "SHO013",
                    "subCategoryName": "스포츠용품"
                },
                {
                    "subCategoryId": "SHO014",
                    "subCategoryName": "핸드폰/주변기기"
                },
                {
                    "subCategoryId": "SHO015",
                    "subCategoryName": "대여"
                },
                {
                    "subCategoryId": "SHO016",
                    "subCategoryName": "슈퍼마켓"
                },
                {
                    "subCategoryId": "SHO017",
                    "subCategoryName": "쇼핑 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "뷰티",
            "categoryId": "BEU",
            "subCategories": [
                {
                    "subCategoryId": "BEU001",
                    "subCategoryName": "화장품"
                },
                {
                    "subCategoryId": "BEU002",
                    "subCategoryName": "헤어"
                },
                {
                    "subCategoryId": "BEU003",
                    "subCategoryName": "스킨"
                },
                {
                    "subCategoryId": "BEU004",
                    "subCategoryName": "네일"
                },
                {
                    "subCategoryId": "BEU005",
                    "subCategoryName": "뷰티정보"
                },
                {
                    "subCategoryId": "BEU006",
                    "subCategoryName": "다이어트/체형관리"
                },
                {
                    "subCategoryId": "BEU007",
                    "subCategoryName": "뷰티 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "여행/레저/스포츠",
            "categoryId": "TRI",
            "subCategories": [
                {
                    "subCategoryId": "TRI001",
                    "subCategoryName": "놀이/레저"
                },
                {
                    "subCategoryId": "TRI002",
                    "subCategoryName": "유아놀이시설"
                },
                {
                    "subCategoryId": "TRI003",
                    "subCategoryName": "여행사"
                },
                {
                    "subCategoryId": "TRI004",
                    "subCategoryName": "숙박시설"
                },
                {
                    "subCategoryId": "TRI005",
                    "subCategoryName": "여행정보"
                },
                {
                    "subCategoryId": "TRI006",
                    "subCategoryName": "운동시설"
                },
                {
                    "subCategoryId": "TRI007",
                    "subCategoryName": "여행/레저/스포츠 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "엔터테인먼트",
            "categoryId": "MED",
            "subCategories": [
                {
                    "subCategoryId": "MED001",
                    "subCategoryName": "게임 "
                },
                {
                    "subCategoryId": "MED002",
                    "subCategoryName": "공연/전시/축제"
                },
                {
                    "subCategoryId": "MED003",
                    "subCategoryName": "만화/애니"
                },
                {
                    "subCategoryId": "MED004",
                    "subCategoryName": "미술/디자인 "
                },
                {
                    "subCategoryId": "MED005",
                    "subCategoryName": "방송"
                },
                {
                    "subCategoryId": "MED006",
                    "subCategoryName": "뉴스"
                },
                {
                    "subCategoryId": "MED007",
                    "subCategoryName": "책/잡지"
                },
                {
                    "subCategoryId": "MED008",
                    "subCategoryName": "영화"
                },
                {
                    "subCategoryId": "MED009",
                    "subCategoryName": "음악"
                },
                {
                    "subCategoryId": "MED010",
                    "subCategoryName": "문화시설"
                },
                {
                    "subCategoryId": "MED011",
                    "subCategoryName": "노래방"
                },
                {
                    "subCategoryId": "MED012",
                    "subCategoryName": "영화관"
                },
                {
                    "subCategoryId": "MED013",
                    "subCategoryName": "소속사/연예인"
                },
                {
                    "subCategoryId": "MED014",
                    "subCategoryName": "미디어/엔터테인먼트 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:33.000+09",
            "categoryName": "자동차/교통",
            "categoryId": "CAR",
            "subCategories": [
                {
                    "subCategoryId": "CAR001",
                    "subCategoryName": "자동차"
                },
                {
                    "subCategoryId": "CAR002",
                    "subCategoryName": "교통"
                },
                {
                    "subCategoryId": "CAR003",
                    "subCategoryName": "중고판매"
                },
                {
                    "subCategoryId": "CAR004",
                    "subCategoryName": "대리운전"
                },
                {
                    "subCategoryId": "CAR005",
                    "subCategoryName": "수리/튜닝"
                },
                {
                    "subCategoryId": "CAR006",
                    "subCategoryName": "렌트/리스"
                },
                {
                    "subCategoryId": "CAR007",
                    "subCategoryName": "자동차/교통 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "기관/단체",
            "categoryId": "ORG",
            "subCategories": [
                {
                    "subCategoryId": "ORG001",
                    "subCategoryName": "공공/행정"
                },
                {
                    "subCategoryId": "ORG002",
                    "subCategoryName": "비영리"
                },
                {
                    "subCategoryId": "ORG003",
                    "subCategoryName": "정치/사회"
                },
                {
                    "subCategoryId": "ORG004",
                    "subCategoryName": "복지"
                },
                {
                    "subCategoryId": "ORG005",
                    "subCategoryName": "종교"
                },
                {
                    "subCategoryId": "ORG006",
                    "subCategoryName": "모임"
                },
                {
                    "subCategoryId": "ORG007",
                    "subCategoryName": "기관/단체 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "금융",
            "categoryId": "FIN",
            "subCategories": [
                {
                    "subCategoryId": "FIN001",
                    "subCategoryName": "은행"
                },
                {
                    "subCategoryId": "FIN002",
                    "subCategoryName": "저축은행"
                },
                {
                    "subCategoryId": "FIN003",
                    "subCategoryName": "카드"
                },
                {
                    "subCategoryId": "FIN004",
                    "subCategoryName": "증권"
                },
                {
                    "subCategoryId": "FIN005",
                    "subCategoryName": "보험"
                },
                {
                    "subCategoryId": "FIN006",
                    "subCategoryName": "부동산"
                },
                {
                    "subCategoryId": "FIN007",
                    "subCategoryName": "금융 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "서비스",
            "categoryId": "SRV",
            "subCategories": [
                {
                    "subCategoryId": "SRV001",
                    "subCategoryName": "광고/마케팅 "
                },
                {
                    "subCategoryId": "SRV002",
                    "subCategoryName": "생활"
                },
                {
                    "subCategoryId": "SRV003",
                    "subCategoryName": "비즈니스"
                },
                {
                    "subCategoryId": "SRV004",
                    "subCategoryName": "건축/기술/과학"
                },
                {
                    "subCategoryId": "SRV005",
                    "subCategoryName": "법률/회계/세무"
                },
                {
                    "subCategoryId": "SRV006",
                    "subCategoryName": "취업/창업"
                },
                {
                    "subCategoryId": "SRV007",
                    "subCategoryName": "서비스 일반"
                }
            ]
        },
        {
            "updateDate": "2019-11-14T10:28:34.000+09",
            "categoryName": "제조",
            "categoryId": "MAN",
            "subCategories": [
                {
                    "subCategoryId": "MAN001",
                    "subCategoryName": "전자"
                }
            ]
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "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>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

브랜드ID - 브랜드 등록 시 자동 생성됩니다.

name

string

브랜드 이름 - 브랜드 등록 시 지정합니다.

brandKey

string

브랜드 Key - 브랜드 등록 시 자동 생성됩니다.

registerDate

string

등록일시 - 브랜드 등록 일시입니다.

approvalDate

string

승인일시 - 브랜드가 검수에서 승인된 일시입니다.

updateDate

string

수정일시 - 브랜드의 정보가 수정된 일시입니다.

status

브랜드의 상태 입니다.

저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.
승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.
검수시작 : 브랜드 검수가 시작된 상태입니다.
승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.
반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.
검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.
승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.
검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.
반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.
검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다. 브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.

array<object>

이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.

chatbotDate

string

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

messagebaseDate

string

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

logoDate

string

로고이미지 수정일

mediaUrl - array<object>

필드명

타입

길이

필수여부

기본값

설명

fileId

string

url

string

typeName

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

fileName

string

등록한 파일의 이름입니다.

pagination - object

필드명

타입

길이

필수여부

기본값

설명

total

integer

전체건수

offset

integer

조회 기준 위치

limit

integer

100

페이지 당 조회 건수

links - object

필드명

타입

길이

필수여부

기본값

설명

prev

string

이전페이지URL

next

string

다음페이지URL

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-05-17T17:49:24.000+09",
            "approvalDate": "2024-05-17T17:49:24.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "background"
                },
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ]
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

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

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

브랜드 상세 조회

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드 상세 정보 객체입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

브랜드ID - 브랜드 등록 시 자동 생성됩니다.

name

string

브랜드 이름 - 브랜드 등록 시 지정합니다.

brandKey

string

브랜드 Key - 브랜드 등록 시 자동 생성됩니다.

registerDate

string

등록일시 - 브랜드 등록 일시입니다.

approvalDate

string

승인일시 - 브랜드가 검수에서 승인된 일시입니다.

updateDate

string

수정일시 - 브랜드의 정보가 수정된 일시입니다.

status

브랜드의 상태 입니다.

저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.
승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.
검수시작 : 브랜드 검수가 시작된 상태입니다.
승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.
반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.
검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.
승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.
검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.
반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.
검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다. 브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.

array<object>

이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.

chatbotDate

string

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

logoDate

string

로고이미자 중 가장 최근에 변경된 일시 정보입니다.

messagebaseDate

string

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

description

string

150

브랜드 설명에 등록된 내용입니다.

tel

string

브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.

array<object>

브랜드 홈에는 최대 4개까지 표시됩니다. chat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.

categoryId

string

브랜드 카테고리 ID 입니다.

categoryName

string

브랜드 카테고리 명 입니다.

subCategoryId

string

브랜드 하위 카테고리 ID 입니다.

subCategoryName

string

브랜드 하위 카테고리 명 입니다.

categoryOpt

string

검색용 키워드 임의 등록 할 수 있습니다.

zipCode

string

브랜드 홈에 표시될 우편번호(5자리) 입니다.

roadAddress

string

200

브랜드 홈에 표시되는 도로명주소 입니다.

detailAddress

string

200

브랜드 홈에 표시되는 상세주소 입니다.

email

string

브랜드 홈에 표시되는 이메일주소 입니다.

webSiteUrl

string

128

브랜드 홈에 표시되는 홈페이지 주소 입니다.

approvalReason

string

검수 시 반려 사유가 제공됩니다.

brandFeedUrl

string

브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.

initTab

string

FEED

단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.

FEED: 소식탭을 기본 탭으로 지정합니다.
INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.

initFeedItems

array<string>

initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다. menus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다. menus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.

Allowed values

"call"
"web"
"store"
"order"
"buy"
"tickets"
"moreinfo"
"portalsearch"

Example["call", "web", "moreinfo", "portalsearch"]

templateColor

string

브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.

bizInfoYn

string

브랜드 소식탭에 운영정보 사용 여부를 설정합니다.

bizInfoTitle

string

bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.

bizInfoContent

string

200

bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.

mediaUrl - array<object>

필드명

타입

길이

필수여부

기본값

설명

fileId

string

url

string

typeName

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

fileName

string

등록한 파일의 이름입니다.

menus - array<object>

필드명

타입

길이

필수여부

기본값

설명

buttonType

string

applink

string

weblink

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "approvalReason": "승인완료(비승인)",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-06-03T15:16:31.000+09",
            "approvalDate": "2024-06-03T15:14:19.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "https://si-www-qa.rcsbizcenter.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트브랜드입니다.",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시",
            "detailAddress": "109-5",
            "email": "hong@google.com",
            "webSiteUrl": "https://si-www-qa.rcsbizcenter.com",
            "brandFeedUrl": null,
            "initTab": "INO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 등록 승인 요청

Request

❖ Request body form data sample

'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"신규브랜드등록승인요청\",
        \"tel\": \"09046123177\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"03924\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"17층\",
        \"menus\": [ {\"buttonType\": \"call\"}, {\"buttonType\": \"chat\"} ]
    }
}"' \

'chatbots="{
    \"chatbots\": [{
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호1\"
        }, {
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호2\"
        }
    ]
}"' \

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

등록된 브랜드ID 입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

등록된 브랜드ID 입니다.

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64305",
        "message": "Missing Certification document"
    },
    "status": 400
}

{
    "error": {
        "code": "64341",
        "message": "Duplicate MDN 09046120000 in chatbots"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63002",
        "message": "No Permission"
    },
    "status": 403
}

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

브랜드 등록 승인 요청 취소

Request

Response

result - array<object>

❖ response body sample

반려 브랜드 등록 재승인 요청

Request

❖ request body form data sample

'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"반려브랜드등록재승인요청\",
        \"tel\": \"09046123177\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"03924\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"17층\",
        \"menus\": [ {\"buttonType\": \"call\"}, {\"buttonType\": \"chat\"} ]
    }
}"' \

'chatbots="{
    \"chatbots\": [{
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호1\"
        }, {
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호2\"
        }
    ]
}"' \

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

등록된 브랜드ID 입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

등록된 브랜드ID 입니다.

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64305",
        "message": "Missing Certification document"
    },
    "status": 400
}

{
    "error": {
        "code": "64341",
        "message": "Duplicate MDN 09046120000 in chatbots"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 수정 승인 요청

Request

❖ request body form data sample

'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"테스트브랜드\",
        \"tel\": \"30000800\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"55110\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"109-5\",
        \"webSiteUrl\": \"http://www.google.com\",
        \"email\": \"lng0415@naver.com\",
        \"initTab\": \"INFO\",
        \"initFeedItem\": \"HOME\",
        \"menus\": [
            {
                \"buttonType\": \"tickets\",
                \"weblink\": \"http://www.google.com\"
            }
        ]
    }
}"' \

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드 상세 정보 객체입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

브랜드ID - 브랜드 등록 시 자동 생성됩니다.

name

string

브랜드 이름 - 브랜드 등록 시 지정합니다.

brandKey

string

브랜드 Key - 브랜드 등록 시 자동 생성됩니다.

registerDate

string

등록일시 - 브랜드 등록 일시입니다.

approvalDate

string

승인일시 - 브랜드가 검수에서 승인된 일시입니다.

updateDate

string

수정일시 - 브랜드의 정보가 수정된 일시입니다.

status

브랜드의 상태 입니다.

저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.
승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.
검수시작 : 브랜드 검수가 시작된 상태입니다.
승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.
반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.
검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.
승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.
검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.
반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.
검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다. 브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.

array<object>

이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.

chatbotDate

string

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

logoDate

string

로고이미자 중 가장 최근에 변경된 일시 정보입니다.

messagebaseDate

string

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

description

string

150

브랜드 설명에 등록된 내용입니다.

tel

string

브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.

array<object>

categoryId

string

브랜드 카테고리 ID 입니다.

categoryName

string

브랜드 카테고리 명 입니다.

subCategoryId

string

브랜드 하위 카테고리 ID 입니다.

subCategoryName

string

브랜드 하위 카테고리 명 입니다.

categoryOpt

string

검색용 키워드 임의 등록 할 수 있습니다.

zipCode

string

브랜드 홈에 표시될 우편번호(5자리) 입니다.

roadAddress

string

200

브랜드 홈에 표시되는 도로명주소 입니다.

detailAddress

string

200

브랜드 홈에 표시되는 상세주소 입니다.

email

string

브랜드 홈에 표시되는 이메일주소 입니다.

webSiteUrl

string

128

브랜드 홈에 표시되는 홈페이지 주소 입니다.

approvalReason

string

검수 시 반려 사유가 제공됩니다.

brandFeedUrl

string

브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.

initTab

string

FEED

단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.

FEED: 소식탭을 기본 탭으로 지정합니다.
INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.

initFeedItems

array<string>

Allowed values

"call"
"web"
"store"
"order"
"buy"
"tickets"
"moreinfo"
"portalsearch"

Example["call", "web", "moreinfo", "portalsearch"]

templateColor

string

브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.

bizInfoYn

string

브랜드 소식탭에 운영정보 사용 여부를 설정합니다.

bizInfoTitle

string

bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.

bizInfoContent

string

200

bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.

mediaUrl - array<object>

필드명

타입

길이

필수여부

기본값

설명

fileId

string

url

string

typeName

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

fileName

string

등록한 파일의 이름입니다.

필드명

타입

길이

필수여부

기본값

설명

buttonType

string

applink

string

weblink

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "approvalReason": "승인완료(비승인)",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-06-03T15:16:31.000+09",
            "approvalDate": "2024-06-03T15:14:19.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "http://www.naver.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트브랜드",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시",
            "detailAddress": "109-5",
            "email": "lng0415@naver.com",
            "webSiteUrl": "http://www.google.com",
            "brandFeedUrl": null,
            "initTab": "INFO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 수정 승인 요청 취소

Request

Response

result - array<object>

❖ response body sample

브랜드 삭제

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

삭제한 브랜드 ID 입니다.

code

string

20000000

status

integer

200

desc

string

`result` - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

삭제한 브랜드 ID 입니다.

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT"
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 삭제 요청(미승인 이력)

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

삭제한 브랜드 ID 입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

삭제한 브랜드 ID 입니다.

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 운영 권한 조회

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드의 권한 정보 객체입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

privilegeType

string

권한은 다음과 같이 구분됩니다.

Manager : 브랜드 관리자(=마스터)
SubManager : 브랜드 부관리자(=마스터, 매니저)
Agency : 브랜드 대행사

id

string

마스터, 매니저 또는 대행사의 ID입니다.

status

string

권한 처리 상태를 표시합니다.

Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다.
Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다.
Ok : 권한 상태가 정상적인 경우 표시됩니다.

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "privilegeType": "Manager",
            "id": "hong",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy59",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy123",
            "contracts": [],
            "status": "Ok"
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 대표 운영자 권한 위임

Request

❖ request body sample

{
    "regPrivileges": [
        {
            "privilegeType": "Manager",
            "id": "hong"
        }
    ]
}

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드의 권한 정보 객체입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

privilegeType

string

권한은 다음과 같이 구분됩니다.

Manager : 브랜드 관리자(=마스터)
SubManager : 브랜드 부관리자(=마스터, 매니저)
Agency : 브랜드 대행사

id

string

마스터, 매니저 또는 대행사의 ID입니다.

status

string

권한 처리 상태를 표시합니다.

Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다.
Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다.
Ok : 권한 상태가 정상적인 경우 표시됩니다.

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "privilegeType": "Manager",
            "id": "hong",
            "contracts": [],
            "status": "Ok"
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64323",
        "message": "No changes"
    },
    "status": 400
}

{
    "error": {
        "code": "64349",
        "message": "hong has not qualified"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [privilegeType]"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 운영자 권한 부여

Request

❖ request body sample

Response

result - array<object>

❖ response body sample

브랜드 운영 권한 삭제

Request

Response

result - array<object>

❖ response body sample

브랜드 상세 조회

Request

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드 상세 정보 객체입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

브랜드ID - 브랜드 등록 시 자동 생성됩니다.

name

string

브랜드 이름 - 브랜드 등록 시 지정합니다.

brandKey

string

브랜드 Key - 브랜드 등록 시 자동 생성됩니다.

registerDate

string

등록일시 - 브랜드 등록 일시입니다.

approvalDate

string

승인일시 - 브랜드가 검수에서 승인된 일시입니다.

updateDate

string

수정일시 - 브랜드의 정보가 수정된 일시입니다.

status

브랜드의 상태 입니다.

저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.
승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.
검수시작 : 브랜드 검수가 시작된 상태입니다.
승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.
반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.
검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.
승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.
검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.
반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.
검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다. 브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.

array<object>

이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.

chatbotDate

string

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

logoDate

string

로고이미자 중 가장 최근에 변경된 일시 정보입니다.

messagebaseDate

string

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

description

string

150

브랜드 설명에 등록된 내용입니다.

tel

string

브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.

array<object>

categoryId

string

브랜드 카테고리 ID 입니다.

categoryName

string

브랜드 카테고리 명 입니다.

subCategoryId

string

브랜드 하위 카테고리 ID 입니다.

subCategoryName

string

브랜드 하위 카테고리 명 입니다.

categoryOpt

string

검색용 키워드 임의 등록 할 수 있습니다.

zipCode

string

브랜드 홈에 표시될 우편번호(5자리) 입니다.

roadAddress

string

200

브랜드 홈에 표시되는 도로명주소 입니다.

detailAddress

string

200

브랜드 홈에 표시되는 상세주소 입니다.

email

string

브랜드 홈에 표시되는 이메일주소 입니다.

webSiteUrl

string

128

브랜드 홈에 표시되는 홈페이지 주소 입니다.

approvalReason

string

검수 시 반려 사유가 제공됩니다.

brandFeedUrl

string

브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.

initTab

string

FEED

단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.

FEED: 소식탭을 기본 탭으로 지정합니다.
INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.

initFeedItems

array<string>

Allowed values

"call"
"web"
"store"
"order"
"buy"
"tickets"
"moreinfo"
"portalsearch"

Example["call", "web", "moreinfo", "portalsearch"]

templateColor

string

브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.

bizInfoYn

string

브랜드 소식탭에 운영정보 사용 여부를 설정합니다.

bizInfoTitle

string

bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.

bizInfoContent

string

200

bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.

mediaUrl - array<object>

필드명

타입

길이

필수여부

기본값

설명

fileId

string

url

string

typeName

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

fileName

string

등록한 파일의 이름입니다.

menus - array<object>

필드명

타입

길이

필수여부

기본값

설명

buttonType

string

applink

string

weblink

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "approvalReason": "승인완료(비승인)",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-06-03T15:16:31.000+09",
            "approvalDate": "2024-06-03T15:14:19.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-qa.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "https://si-www-qa.rcsbizcenter.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트브랜드입니다.",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시",
            "detailAddress": "109-5",
            "email": "hong@google.com",
            "webSiteUrl": "https://si-www-qa.rcsbizcenter.com",
            "brandFeedUrl": null,
            "initTab": "INO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드 수정 승인 요청

Request

❖ request body form data sample

'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"테스트브랜드\",
        \"tel\": \"30000800\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"55110\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"109-5\",
        \"webSiteUrl\": \"http://www.google.com\",
        \"email\": \"lng0415@naver.com\",
        \"initTab\": \"INFO\",
        \"initFeedItem\": \"HOME\",
        \"menus\": [
            {
                \"buttonType\": \"tickets\",
                \"weblink\": \"http://www.google.com\"
            }
        ]
    }
}"' \

Response

필드명

타입

길이

필수여부

기본값

설명

array<object>

브랜드 상세 정보 객체입니다.

code

string

20000000

status

integer

200

desc

string

result - array<object>

필드명

타입

길이

필수여부

기본값

설명

brandId

string

브랜드ID - 브랜드 등록 시 자동 생성됩니다.

name

string

브랜드 이름 - 브랜드 등록 시 지정합니다.

brandKey

string

브랜드 Key - 브랜드 등록 시 자동 생성됩니다.

registerDate

string

등록일시 - 브랜드 등록 일시입니다.

approvalDate

string

승인일시 - 브랜드가 검수에서 승인된 일시입니다.

updateDate

string

수정일시 - 브랜드의 정보가 수정된 일시입니다.

status

브랜드의 상태 입니다.

저장 : RCS Biz Center 홈페이지에서 브랜드 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 브랜드는 승인요청을 해야 승인대기 상태로 변경됩니다.
승인대기 : 브랜드 등록 직후 검수 이전 상태입니다.
검수시작 : 브랜드 검수가 시작된 상태입니다.
승인 : 검수가 완료되어 이통3사에 브랜드 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.
반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 브랜드는 수정 후 다시 승인요청 할 수 있습니다.
검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.
승인대기(수정) : 승인된 브랜드 변경 시 검수 대상으로 판단되어 검수 요청된 상태입니다.
검수시작(수정) : 승인된 브랜드 변경으로 승인요청된 브랜드 검수가 시작된 상태입니다.
반려(수정) : 승인된 브랜드 변경 검수 처리 결과 반려된 상태입니다.
검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다. 브랜드 조회 API 호출 시 수정 이전 브랜드 정보가 제공됩니다.

array<object>

이미지 파일ID와 URL 및 사용 유형 정보를 제공합니다.

chatbotDate

string

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

logoDate

string

로고이미자 중 가장 최근에 변경된 일시 정보입니다.

messagebaseDate

string

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

description

string

150

브랜드 설명에 등록된 내용입니다.

tel

string

브랜드홈에 노출될 전화번호(대표발신번호와 별개) 입니다.

array<object>

categoryId

string

브랜드 카테고리 ID 입니다.

categoryName

string

브랜드 카테고리 명 입니다.

subCategoryId

string

브랜드 하위 카테고리 ID 입니다.

subCategoryName

string

브랜드 하위 카테고리 명 입니다.

categoryOpt

string

검색용 키워드 임의 등록 할 수 있습니다.

zipCode

string

브랜드 홈에 표시될 우편번호(5자리) 입니다.

roadAddress

string

200

브랜드 홈에 표시되는 도로명주소 입니다.

detailAddress

string

200

브랜드 홈에 표시되는 상세주소 입니다.

email

string

브랜드 홈에 표시되는 이메일주소 입니다.

webSiteUrl

string

128

브랜드 홈에 표시되는 홈페이지 주소 입니다.

approvalReason

string

검수 시 반려 사유가 제공됩니다.

brandFeedUrl

string

브랜드 소식 URL 입니다. 브랜드 소식을 최초 등록하거나 브랜드 홈 기본 탭을 소식탭(FEED)로 설정하면 자동 생성됩니다.

initTab

string

FEED

단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다. 미지정 시 기본값은 FEED 입니다.

FEED: 소식탭을 기본 탭으로 지정합니다.
INFO: 정보탭을 기본 탭으로 지정합니다. 브랜드 최초 승인 시에만 선택이 가능하며 승인 이후에는 수정이 불가합니다.

initFeedItems

array<string>

Allowed values

"call"
"web"
"store"
"order"
"buy"
"tickets"
"moreinfo"
"portalsearch"

Example["call", "web", "moreinfo", "portalsearch"]

templateColor

string

브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.

bizInfoYn

string

브랜드 소식탭에 운영정보 사용 여부를 설정합니다.

bizInfoTitle

string

bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.

bizInfoContent

string

200

bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.

mediaUrl - array<object>

필드명

타입

길이

필수여부

기본값

설명

fileId

string

url

string

typeName

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

fileName

string

등록한 파일의 이름입니다.

필드명

타입

길이

필수여부

기본값

설명

buttonType

string

applink

string

weblink

string

이미지의 사용 유형을 구분합니다.

icon - 템플릿 양식 아이콘 이미지
profile - 브랜드 프로필 이미지
background - 브랜드 백그라운드 이미지

❖ response body sample

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.i3gC1762pT",
            "name": "테스트브랜드",
            "brandKey": "BK.2G3Dar9X4j0yCEb",
            "status": "승인",
            "approvalReason": "승인완료(비승인)",
            "chatbotDate": null,
            "messagebaseDate": "2024-05-17T17:48:07.000+09",
            "logoDate": null,
            "registerDate": "2024-05-17T17:48:07.000+09",
            "updateDate": "2024-06-03T15:16:31.000+09",
            "approvalDate": "2024-06-03T15:14:19.000+09",
            "mediaUrl": [
                {
                    "fileId": "LT-common-1WUqPj",
                    "fileName": "통신.png",
                    "url": "https://file-dev.rcsbizcenter.com/brand/common/LT-common-1WUqPj_1.png",
                    "typeName": "profile"
                }
            ],
            "menus": [
                {
                    "buttonType": "tickets",
                    "weblink": "http://www.naver.com",
                    "feedinfoYn": "N"
                }
            ],
            "description": "테스트브랜드",
            "tel": "30000800",
            "categoryId": "EDU",
            "categoryName": "교육",
            "subCategoryId": "EDU007",
            "subCategoryName": "유학/연수",
            "categoryOpt": null,
            "zipCode": "55110",
            "roadAddress": "서울특별시",
            "detailAddress": "109-5",
            "email": "lng0415@naver.com",
            "webSiteUrl": "http://www.google.com",
            "brandFeedUrl": null,
            "initTab": "INFO",
            "initFeedItems": [],
            "templateColor": null,
            "bizInfoYn": "N",
            "bizInfoTitle": null,
            "bizInfoContent": null
        }
    ],
    "status": 200
}

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}

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

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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

브랜드

브랜드 카테고리 목록 조회

Request

Response

result - array<object>

subCategories - array<object>

❖ response body sample

브랜드 목록 조회

Request

Response

result - array<object>

mediaUrl - array<object>

pagination - object

links - object

❖ response body sample

브랜드 상세 조회

Request

Response

result - array<object>

mediaUrl - array<object>

menus - array<object>

❖ response body sample

브랜드 등록 승인 요청

Request

❖ Request body form data sample

Response

result - array<object>

❖ response body sample

브랜드 등록 승인 요청 취소

Request

Response

result - array<object>

❖ response body sample

반려 브랜드 등록 재승인 요청

Request

❖ request body form data sample

Response

result - array<object>

❖ response body sample

브랜드 수정 승인 요청

Request

❖ request body form data sample

Response

result - array<object>

mediaUrl - array<object>

menu - array<object>

❖ response body sample

브랜드 수정 승인 요청 취소

Request

Response

result - array<object>

❖ response body sample

브랜드 삭제

Request

Response

result - array<object>

❖ response body sample

브랜드 삭제 요청(미승인 이력)

Request

Response

result - array<object>

❖ response body sample

브랜드 운영 권한 조회

Request

Response

result - array<object>

❖ response body sample

브랜드 대표 운영자 권한 위임

Request

❖ request body sample

Response

result - array<object>

❖ response body sample

브랜드 운영자 권한 부여

Request

❖ request body sample

Response

result - array<object>

❖ response body sample

브랜드 운영 권한 삭제

`result` - array<object>

`result` - array<object>