로고 목록 조회

Request

브랜드 별 등록된 로고 목록을 조회합니다.

브랜드 별 등록된 로고 목록을 조회합니다.

• 계정 권한: 마스터, 매니저, 대행사
• 브랜드 권한: 브랜드 대표운영자, 운영자

get

/brand/{brandId}/logo

Authorizations

Path parameters

brandIdstring · max: 13required

maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.

Query parameters

offsetinteger · default: 0

시작 offset 번호(default: 0) 입니다.

limitinteger · min: 100 · max: 1000 · default: 100

조회 최대 건수(default: 100, maximum: 1000) 입니다.

Header parameters

X-RCS-Brandkeystring · max: 18

maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.

대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-qa.rcsbizcenter.com/api/1.1/brand/{brandId}/logo' \
  --header 'Authorization: Bearer JWT'

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<object>		O		브랜드 로고 정보
code	string	5	O	20000000
status	integer	3	O	200
desc	string		O
pagination	object		O		전체 건수와 페이징 조건을 제공합니다.
links	object		O		이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.

result - array<object>

필드명	타입	길이	필수여부	기본값	설명
fileId	string	64			로고 이미지 파일 ID 입니다.
fileUrl	string	1000			로고 이미지 파일 URL 입니다.
name	string	30			로고명 입니다.
fileName	string	256			원본 파일명 입니다.
description	string	100			로고 설명입니다.
viaTemplate	string				템플릿 등록 시 추가된 이미지가 로고로 등록된 경우 해당 템플릿(messagebase) ID 를 표시합니다. 템플릿ID가 존재하는 로고 파일ID는 다른 템플릿 등록 시 사용할 수 없습니다.
approvalResult	string				로고 승인 상태입니다. 저장 : RCS Biz Center 홈페이지에서 승인요청 하지 않고 저장 또는 승인요청 취소된 상태입니다. 저장 상태의 로고는 승인요청을 해야 승인대기 상태로 변경됩니다. 승인대기 : 로고 등록 직후 검수 이전 상태입니다. 검수시작 : 로고 검수가 시작된 상태입니다. 승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지 발송시 사용 가능한 상태입니다. 반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 로고는 수정 후 다시 승인요청 할 수 있습니다. 검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송시 사용할 수 없습니다. 승인대기(수정) : 승인된 로고를 수정하여 다시 승인요청한 상태입니다. 검수시작(수정) : 승인된 로고를 수정하여 다시 승인요청된 로고의 검수가 시작된 상태입니다. 반려(수정) : 승인된 로고를 수정하여 다시 승인요청 후 검수 처리 결과 반려된 상태입니다. 검수완료(수정) : 승인된 로고를 수정하여 다시 승인요청 후 검수 승인은 되었으나 이통3사 정보 갱신이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 로고가 다르게 표시될 수 있습니다.
approvalReason	string				승인 사유
registerDate	string				로고 등록일시
approvalDate	string				로고 승인일시
updateDate	string				로고 수정일시
registerId	string	20			로고 등록 계정 ID
updateId	string	20			로고 수정 계정 ID

pagination - object

필드명	타입	길이	필수여부	기본값	설명
total	integer		O		전체건수
offset	integer		O	0	조회 기준 위치
limit	integer		O	100	페이지 당 조회 건수

links - object

필드명	타입	길이	필수여부	기본값	설명
prev	string		O		이전페이지URL
next	string		O		다음페이지URL

❖ response body sample

200

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O",
            "fileUrl": "https://file-qa.rcsbizcenter.com/brand/BR.61hBmMP164/logo/BLG-BR.61hBmMP164-Jt1O_1.png",
            "name": "통신",
            "fileName": "통신.png",
            "approvalResult": "저장",
            "viaTemplate": null,
            "description": "통신",
            "approvalReason": "승인요청 취소",
            "registerDate": "2024-07-08 10:10:30",
            "approvalDate": null,
            "updateDate": "2024-07-08 10:16:16",
            "registerId": "hong",
            "updateId": "hong"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 1
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}

400

{
    "error": {
        "code": "64001",
        "message": "Missing X-RCS-BrandKey header"
    },
    "status": 400
}

401

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

403

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

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