템플릿 이미지 등록_V2

Request

이미지 템플릿에서 사용할 이미지 파일을 등록합니다.

이미지 템플릿에서 사용할 이미지 파일을 등록합니다.
파일을 먼저 등록해야 이미지 템플릿 등록 시 file Id를 템플릿 내 지정할 수 있습니다.

• 계정 권한: 마스터, 매니저, 대행사
• 브랜드 권한: 브랜드 대표운영자, 운영자
• 지원 범위: 이미지 템플릿, LMS 템플릿

post

/brand/{brandId}/v2/messagebase/file

Authorizations

Path parameters

brandIdstring · max: 13required

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

Header parameters

X-RCS-Brandkeystring · max: 18

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

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

Body

fileobject · binaryrequired

이미지 템플릿에 사용할 이미지 파일입니다.

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-qa.rcsbizcenter.com/api/1.1/brand/{brandId}/v2/messagebase/file' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=[object Object]'

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<object>		O		이미지 템플릿용 파일 등록 정보입니다.
code	string	5	O	20000000
status	integer	3	O	200
desc	string		O

result - array<object>

필드명	타입	길이	필수여부	기본값	설명
fileId	string	64	O		이미지 템플릿용 파일 등록 정보입니다.
url	string	128			등록된 파일의 URL 정보 입니다.
fileName	string	256			등록한 파일의 이름입니다.
imageWidth	integer				이미지 가로 크기 입니다.
imageHeight	integer				이미지 세로 크기 입니다.

❖ response body sample

200

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "fileId": "LT-BR.u720xwadx0-17CJ",
            "fileName": "BR.275F8GY6nR-FD4DBi3W06i5.jpg",
            "url": "https://file-qa.rcsbizcenter.com/brand/BR.u720xwadx0/template/LT-BR.u720xwadx0-17CJ_1.jpg",
            "imageWidth": 1080,
            "imageHeight": 1080
        }
    ],
    "status": 200
}

400

{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}

401

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

403

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

500

{
    "error": {
        "code": "69999",
        "message": "null[org.springframework.web.multipart.MultipartException-Current request is not a multipart request]"
    },
    "status": 500
}

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