브랜드 소식 이미지 등록

Request

소식에 사용되는 이미지 파일을 등록합니다.

소식에 사용되는 이미지 파일을 등록합니다. slide인 경우 정사각형 비율만 허용됩니다.

post

/brand/{brandId}/feed/file

Authorizations

Path parameters

brandIdstringrequired

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

Header parameters

X-RCS-Brandkeystring

maxLength: 36 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다. 대행사가 브랜드 소식 API 연동 시 Header에 반드시 설정하여야 합니다.

Body

filestring · binary

브랜드 소식에 사용할 이미지 파일입니다.

typestring · enum

이미지가 사용될 브랜드 소식 카드 유형

Options: gallery, slide

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-qa.rcsbizcenter.com/bfapi/1.0/brand/{brandId}/feed/file' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=text' \
  --form 'type=gallery'

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<FeedFileInfo>		O		브랜드 소식 파일 등록 정보입니다.
code	string	5	O	20000000	리턴코드값
status	integer	3	O	200	상태값
desc	string		O		처리메시지

result - array<FeedFileInfo>

필드명	타입	길이	필수여부	기본값	설명
fileId	string				등록된 파일의 ID 입니다.
url	string	128			등록된 파일의 URL 정보 입니다.
fileName	string	256			등록한 파일의 이름입니다.
type	string				이미지가 사용될 브랜드 소식 카드 유형(gallery, slide)

❖ response body sample

200

{
    "code": "20000000",
    "desc": null,
    "result": {
        "fileName": "900x900-2.jpg",
        "type": "gallery",
        "url": "https://biz-dev.chatplus.co.kr/brand/BR.61hBmMP164/feed/20240704/BR.61hBmMP164-FDcoZeqOY0W7.jpg",
        "fileId": "BR.61hBmMP164-FDcoZeqOY0W7"
    },
    "status": 200
}

400

{
    "error": {
        "code": "64708",
        "message": "File size not allowed"
    },
    "status": 400
}

401

{
  "status": "401",
  "error": {
    "code": "61001",
    "message": "Missing Authorization header"
  }
}

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

705

{
    "error": {
        "code": "60000705",
        "message": "파일을 읽을 수 없습니다."
    },
    "status": 705
}

error code는 브랜드소식 - Response body error code 참조