# 로고 목록 조회

## Request

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

> 브랜드 별 등록된 로고 목록을 조회합니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*  \
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.12"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/logo":{"get":{"summary":"브랜드 별 등록된 로고 목록을 조회합니다.\n","description":"브랜드 별 등록된 로고 목록을 조회합니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**  \n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드 로고 정보</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

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

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="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
}
```

{% endtab %}

{% tab title="400" %}

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

{% endtab %}

{% tab title="401" %}

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

{% endtab %}

{% tab title="403" %}

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

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](https://apidocs.rcsbizcenter.com/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}