4. 비즈메시지 파일 관리

친구톡 기본/와이드/프리미엄 동영상/커머스 이미지 업로드

API 정보	• 친구톡 기본/와이드/프리미엄 동영상/커머스 이미지를 합니다. • POST /v3/kakao/image/upload • Content-Type: multipart/form-data
요청 파라미터
키	타입	필수	설명
bizId	String	O	BIZPPURIO ID
apiKey	String	O	API 발급 키
image	File	O	이미지 파일(jpg, png) ※ 기본 파일 규격 : JPG, JPEG, PNG만 가능/ 용량 최대 5MB 권장 사이즈 : 720px X 720px(가로 500px 미만, 가로:세로 비율이 2:1 미만 또는 3:4 초과 시 업로드 불가) ※ 와이드 파일 규격 : JPG, JPEG, PNG만 가능/ 용량 최대 5MB 사이즈 : 800px X 600px ※ 프리미엄 동영상 파일 규격 : JPG, JPEG, PNG 만 가능 / 용량 최대 5MB 사이즈 : 가로 500px 이상 (가로:세로 비율 2:1 이상 3:4 이하) ※ 커머스 파일 규격 : JPG, JPEG, PNG 만 가능 / 용량 최대 5MB 사이즈 : 가로 500px 이상 (가로:세로 비율 2:1 이상 3:4 이하)
imageType	String	O	이미지 타입(기본=I, 와이드=W, 프리미엄 동영상=V, 커머스=M)
title	String	O	이미지 제목
link	String	O	이미지 클릭 시 이동할 URL(http:// 또는 https:// 포함) ※ 프리미엄 동영상일 경우 동영상 링크는 카카오TV에 업로드된 영상만 사용가능 https://tv.kakao.com/v/#(숫자) https://tv.kakao.com/channel/#(숫자)/cliplink/#(숫자)
senderKey	String	X	발신프로필키(입력시 : 해당 발신프로필키에 등록, 미입력시 : 공용(해당계정)으로 등록)
반환 값
키	타입	설명
code	String	결과 코드
message	String	실패 시 결과 메시지
image	String	성공 시 이미지가 등록된 카카오 서버 URL

친구톡 와이드 아이템 리스트 이미지 업로드

API 정보	• 친구톡 와이드 아이템 리스트 발송 시 사용될 이미지들을 업로드 합니다. 아이템 리스트 개수(1~4개)에 맞춰서 업로드 합니다. 제한 사이즈 - 가로 400px, 세로 400px ~ 가로 800px, 세로 400px 비율 및 가로 픽셀 확인 X. 썸네일 크기에 맞추어 중앙 기준으로 크롭하여 노출 파일형식 및 크기 : jpg, png / 각 파일 최대 5MB • POST /v3/kakao/image/friendtalk/wideItemList
요청 파라미터
키		타입	필수	설명
bizId		String	O	BIZPPURIO ID
apiKey		String	O	API 발급 키
senderKey		String	X	발신프로필키(입력시 : 해당 발신프로필키에 등록, 미입력시 : 공용(해당계정)으로 등록)
imageList		Array		이미지 정보 리스트
	image	File	O	이미지 파일
	title	String	O	이미지 제목
	link	String	O	이미지 클릭 시 이동할 URL(http:// 또는 https:// 포함)
반환 값
키				타입	설명
code				String	결과 코드
message				String	결과 메시지
data				Object	업로드 결과
	success			Array	성공 결과 목록
		formField		String	업로드 field
		url		String	이미지가 등록된 카카오 서버 URL
	failure			Array	실패 결과 목록
		formField		String	업로드 field
		error		Object	에러 정보
			code	String	에러 코드
			message	String	에러 메시지

친구톡 캐러셀 피드 이미지 업로드

API 정보	• 친구톡 캐러셀 피드 발송 시 사용될 이미지를 업로드 합니다. 캐러셀  개수(1~10개)에 맞춰서 업로드 합니다. 제한 사이즈 - 가로 500px 이상, 가로:세로 비율 2:1 이상 3:4 이하 파일형식 및 크기 : jpg, png / 각 파일 최대 5MB • POST /v3/kakao/image/friendtalk/carousel • Content-Type: multipart/form-data
요청 파라미터
키		타입	필수	설명
bizId		String	O	BIZPPURIO ID
apiKey		String	O	API 발급 키
senderKey		String	X	발신프로필키(입력시 : 해당 발신프로필키에 등록, 미입력시 : 공용(해당계정)으로 등록)
imageList		Array		이미지 정보 리스트
	image	File	O	이미지 파일
	title	String	O	이미지 제목
	link	String	O	이미지 클릭 시 이동할 URL (http:// 또는 https:// 포함)
반환 값
키				타입	설명
code				String	결과 코드
message				String	결과 메시지
data				Object	업로드 결과
	success			Array	성공 결과 목록
		formField		String	업로드 field
		url		String	이미지가 등록된 카카오 서버 URL
	failure			Array	실패 결과 목록
		formField		String	업로드 field
		error		Object	에러 정보
			code	String	에러 코드
			message	String	에러 메시지

친구톡 캐러셀 커머스 이미지 등록

API 정보	• 친구톡 캐러셀 커머스 발송 시 사용될 이미지를 업로드 합니다. 캐러셀  개수(1~11개)에 맞춰서 업로드 합니다. 제한 사이즈 - 가로 500px 이상, 가로:세로 비율 2:1 이상 3:4 이하 파일형식 및 크기 : jpg, png / 각 파일 최대 5MB • POST /v3/kakao/image/friendtalk/carouselCommerce • Content-Type: multipart/form-data
요청 파라미터
키		타입	필수	설명
bizId		String	O	BIZPPURIO ID
apiKey		String	O	API 발급 키
senderKey		String	X	발신프로필키(입력시 : 해당 발신프로필키에 등록, 미입력시 : 공용(해당계정)으로 등록)
imageList		Array		이미지 정보 리스트
	image	File	O	이미지 파일
	title	String	O	이미지 제목
	link	String	O	이미지 클릭 시 이동할 URL(http:// 또는 https:// 포함)
반환 값
키				타입	설명
code				String	결과 코드
message				String	결과 메시지
data				Object	업로드 결과
	success			Array	성공 결과 목록
		formField		String	업로드 field
		url		String	이미지가 등록된 카카오 서버 URL
	failure			Array	실패 결과 목록
		formField		String	업로드 field
		error		Object	에러 정보
			code	String	에러 코드
			message	String	에러 메시지

친구톡 이미지 조

API 정보	• 친구톡 이미지 목록을 조회 합니다. • POST /v3/kakao/image/list • Content-Type: application/json; charset=utf-8
요청 파라미터
키	타입	필수	설명
bizId	String	O	BIZPPURIO ID
apiKey	String	O	API 발급 키
senderKey	String	X	발신프로필키(입력시 : 해당 발신프로필키에 매핑된 이미지 조회, 미입력시 : 공용(해당계정)으로 매핑된 이미지 조회)
imageType	String	O	이미지 타입 (기본=I, 와이드=W, 와이드아이템리스트=L, 캐러셀피드=C, 프리미엄동영상=V, 커머스=M, 캐러셀커머스=A)
반환 값
키		타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Array	성공 시 이미지 목록
	title	String	이미지 제목
	link	String	이미지 클릭 시 이동할 URL(http:// 또는 https:// 포함)
	imageUrl	String	이미지가 등록된 카카오 서버 URL
	createdAt	String	이미지 등록일
	imageType	String	이미지 타입 (기본=I, 와이드=W, 와이드아이템리스트=L, 캐러셀피드=C)

친구톡 이미지 삭제

API 정보	• 등록된 친구톡 이미지를 삭제합니다. • POST /v3/kakao/image/delete • Content-Type: application/json; charset=utf-8
요청 파라미터
키	타입	필수	설명
bizId	String	O	BIZPPURIO ID
apiKey	String	O	API 발급 키
imageUrl	String	O	삭제할 이미지 URL 정보
반환 값
키	타입	설명
code	String	결과 코드
message	String	실패 시 결과 메시지

알림톡 템플릿 등록용 이미지 업로드

API 정보	• 이미지 알림톡 또는 아이템리스트 알림톡 템플릿 등록 시 사용될 이미지를 업로드 합니다. 제한 사이즈 - 가로 500px 이상, 가로:세로 비율 2:1 파일형식 및 크기 : jpg, png / 최대 500KB • POST /v3/kakao/image/alimtalk/template • Content-Type: multipart/form-data
요청 파라미터
키	타입	필수	설명
bizId	String	O	BIZPPURIO ID
apiKey	String	O	API 발급 키
image	File	O	업로드할 이미지 파일
반환 값
키	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
image		String	성공 시 이미지가 등록된 카카오 서버 URL

알림톡 하이라이트 이미지 업로드

API 정보	• 아이템리스트 알림톡 발송 시 사용될 아이템 하이라이트 이미지를 업로드 합니다. 제한 사이즈 - 가로 108px 이상, 가로:세로 비율이 1:1 파일형식 및 크기 : jpg, png / 최대 500KB • POST /v3/kakao/image/alimtalk/itemHighlight • Content-Type: multipart/form-data
요청 파라미터
키	타입	필수	설명
bizId	String	O	BIZPPURIO ID
apiKey	String	O	API 발급 키
image	File	O	업로드할 이미지 파일
반환 값
키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
image		String	성공 시 이미지가 등록된 카카오 서버 URL