https://{TheMangoClient}/api/imagesChange

변경 가능한 이미지 정보는 /api/imagesList API를 통해 확인할 수 있습니다. 여러 개 이미지를 동시에 변경하는 경우, 최대 10개 이미지를 동시에 변경할 수 있습니다.

API Limit

Rate Limit 3 Request(s) / 1 Second(s)
Token Usage 1 Token(s) / 1 Request

Request

Name Required Type Description
 productId ⭕ String
더망고 상품번호
 imageType ⭕ String
이미지타입 - representative : 대표이미지 (대표이미지의 이미지 사이즈는 800x800px, 용량은 150KB 이하 이미지로만 변경 가능합니다.) - detail : 상세페이지 이미지
 imageUrl ⭕ Array
변경대상 이미지 URL - String 형식으로 입력하면, 1개씩 이미지 변경이 가능합니다. - Array 형식으로 이미지를 여러개 입력하면, 여러 개 이미지 동시 변경이 가능합니다. - imageUrl 과 replaceImageUrl 이 Array 인 경우, 두 Array 의 길이가 동일해야 합니다. 같은 인덱스 위치의 이미지끼리 1:1로 교체됩니다.
 replaceImageUrl ⭕ Array
변경할 이미지 URL - String 형식으로 입력하면, 1개씩 이미지 변경이 가능합니다. - Array 형식으로 이미지를 여러개 입력하면, 여러 개 이미지 동시 변경이 가능합니다. - imageUrl 과 replaceImageUrl 이 Array 인 경우, 두 Array 의 길이가 동일해야 합니다. 같은 인덱스 위치의 이미지끼리 1:1로 교체됩니다. - 변경할 이미지 URL 에 "delete" 문구를 입력하면, 해당 이미지가 삭제됩니다. (대표이미지는 삭제할 수 없습니다.)

Response

Name Type Description
 data Object
응답 데이터
    + productId String
더망고 상품번호
    + imageType String
이미지타입
    + errorImages String
오류 이미지 리스트 - 동시에 여러개 이미지를 변경하는 경우, 변경에 오류가 있는 이미지를 출력합니다.

Error Code

Name Description
 CANNOT DELETE REPRESENTATIVE IMAGE 이미지 삭제기능은 대표이미지는 지원하지 않습니다.
 IMAGE NOT FOUND FOR PRODUCT 요청하신 이미지는 해당 상품에 존재하지 않는 이미지입니다.
 IMAGE COUNT MISMATCH 변경할 이미지와 변경대상 이미지의 개수는 동일해야 합니다.
 MAX IMAGE CHANGE COUNT EXCEEDED 한번에 변경 가능한 이미지 개수는 최대 10개입니다.
 REPRESENTATIVE IMAGE SIZE UNKNOWN 대표이미지의 이미지 용량이 확인되지 않습니다.
 REPRESENTATIVE IMAGE FILE SIZE TOO LARGE 대표이미지의 이미지 최대 용량을 초과하였습니다.

API Request Sample

curl --location 'https://{TheMangoClient}/api/imagesChange' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data '{
    "productId": "",
    "imageType": "",
    "imageUrl": [],
    "replaceImageUrl": []
}'