상품 서류 업로드

선물하기 상품 등록/수정 시 카테고리 속성정보가 광고심의서류 필수/선택 카테고리인 경우 광고심의서류 파일 업로드가 가능합니다.

선물하기 상품 등록 시 광고심의서류 필수 카테고리인 경우 해당 카테고리 등록가능한 광고심의서류 종류(건강기능식품, 의료기기, 기타)에 맞는 서류를 등록하지 않으면 상품을 등록할 수 없습니다. 

상품의 서류 등록 시 카카오 서버에 판매자의 서류 파일 업로드 후 카카오에서 응답된 파일 uuid를 상품 등록/수정 요청 시 입력해야 정상처리됩니다. 

광고심의서류 등록 필수/선택 카테고리 확인 후 해당 카테고리의 상품등록 시 필요한 파일을 업로드 해주세요.

참고사항

등록가능한 서류파일의 형식은 jpg, jpeg, png, pdf, tif, tiff, gif만 지원하며 파일 당 10MB 까지 등록가능하고 전체 용량은 20MB를 초과할 수 없습니다. 
1회 파일 업로드 시 최대 10개까지 가능합니다. 
광고심의서류에 해당하는 서류파일은 sellerFileType을 ADVERTISEMENT_REVIEW 로 등록해주세요.

요청

POST /v1/gift/products/seller-files

<요청 파라미터 설명>

<요청 예시>

광고심의서류 업로드 api의 file[ ] 파라미터는 ‘multipart/form-data’ Content-Type 입니다.

url 형태의 문자열은 지원하지 않습니다.

curl -X POST "https://kapi.kakao.com/v1/gift/products/seller-files?sellerFileType=ADVERTISEMENT_REVIEW" \
-H "Content-Type: multipart/form-data" \
-H "accept: */*" \
-H "Authorization: KakaoAK ${대행사키}" \
-H "Target-Authorization: KakaoAK ${판매자키}" \
-H "channel-ids: 1" \
-F "file[]=@${파일1경로}.gif" \
-F "file[]=@${파일2경로}.gif"

응답

성공시에는 판매자 파일 uuid 가 응답바디에 포함됩니다.

<응답 바디>

<응답 바디 샘플>

• 성공

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

[
    {
        "result": "SUCCESS",
        "data": {
            "sellerFileUuid": "d3145fe9-0188-1000-0000-02d7a90b7a9f",
            "originalFilename": "large.gif",
            "mimeType": "image/gif",
            "fileSize": 20834606
        }
    }
]

•  용량초과로 인한 실패

HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8

{
    "msg": "maximum size exceeded. maxUploadSize=20971520bytes",
    "code": -602
}