브랜드 소식 이미지 등록

Request

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

post

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

Authorizations

Path parameters

brandIdstringRequired

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

Header parameters

X-RCS-BrandkeystringOptional

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

Body

filestring · binaryOptional

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

typestring · enumOptional

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

Possible values:

post

HTTPcURLJavaScriptPython

POST /bfapi/1.0/brand/{brandId}/feed/file HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Content-Type: multipart/form-data
Accept: */*
Content-Length: 34

{
  "file": "binary",
  "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 참조