로고 등록 요청

Request

브랜드 내에서 사용할 수 있는 로고를 등록 합니다.

post

브랜드 내에서 사용할 수 있는 로고를 등록 합니다.

등록한 로고는 영구적으로 사용 가능합니다.

템플릿 등록 시 또는 메시지 발송 시 mTitleMedia, itemMedia 에는 로고 파일ID 만 지정이 가능합니다.

다음과 같은 사용은 실패를 유발하므로 주의가 필요합니다.
예1) 템플릿 등록 시 mTitleMedia 에 POST /brand/{brandId}/v2/messagebase/file 로 등록한 이미지 파일ID를 지정하면 등록 실패
예2) 메시지 발송 시 itemMedia 에 이통 메시지 파일 등록 API(POST /file)로 등록한 파일ID를 지정하면 발송 실패

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

Authorizations

Path parameters

brandIdstring · max: 13Required

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

Header parameters

X-RCS-Brandkeystring · max: 18Optional

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

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

Body

브랜드 로고 등록시 사용됩니다.

namestring · max: 30Required

maxLength: 30 - 로고명 입니다.

descriptionstring · max: 100Optional

maxLength: 100 - 100자 이내의 로고 설명 입니다.

fileobject · binaryRequired

업로드 로고 이미지 파일을 지칭합니다.

파일형식 : gif, png, jpeg, jpg, bmp (최대 1MB)

post

HTTPcURLJavaScriptPython

POST /api/1.1/brand/{brandId}/logo HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Content-Type: multipart/form-data
Accept: */*
Content-Length: 46

{
  "name": "text",
  "description": "text",
  "file": {}
}

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<object>		O		등록된 로고 ID 입니다.
code	string	5	O	20000000
status	integer	3	O	200
desc	string		O

result - array<object>

필드명	타입	길이	필수여부	기본값	설명
fileId	string				등록된 로고 ID 입니다.

❖ response body sample

200

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "BLG-BR.61hBmMP164-Jt1O"
        }
    ],
    "status": 200
}

400

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

{
    "error": {
        "code": "64321",
        "message": "Invalid approval status"
    },
    "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 참조