3. 이미지 관리

스마트톡톡 메세지 템플릿에 이미지를 포함하기 위해선 이미지 API 를 이용하여 이미지를 미리 업로드한 뒤, 반환되는 해시값을 활용하여야 합니다.

해당 API 는 다음 2 가지 목적을 위하여 제공합니다. 네이버 포토인프라에 이미지를 업로드하여

1. 정보성 알림 메세지가 해상도에 맞춰서 노출되도록 썸네일을 저장합니다.
2. 추후 클라이언트에서 이미지가 유실되더라도 네이버에 저장된 이미지를 안정적으로 보여줄 수 있습니다.

업로드할 수 있는 이미지 포맷은 JPG, JPEG, PNG, GIF 이며, 이미지 최대 사이즈는 300 KB 입니다.

권장 해상도는 552X552 이며, 해당 사이즈가 아닌 경우에는 크롭하여 보관합니다.

POST /v1/image/upload/url                                                  

이미지 URL 업로드 (uploadUrl)

이미지를 URL 로 업로드 합니다.

-H 'Content-Type: application/json'

-H 'Authorization: Bearer {{accessToken}}'

요청 파라미터
키		-	타입	필수	설명
naverPartnerKey			String	O	파트너키
imageUrl			String	O	업로드할 이미지의 url
imageType			String	O	"content"/"feed", 디폴트 값인 "content"일 경우 생략이 가능합니다. "content" : 일반적인 이미지 사용시에 설정합니다. (해상도 제한은 없지만 '552X552' 권장), 최대 사이즈 '300 KB' 입니다. "feed" : 혜택 feed 에 표시될 이미지 사용시에 설정합니다. 해상도 '598X300'로 고정되며 그 외의 해상도는 업로드시 에러가 발생합니다. 최대 사이즈 '300 KB' 입니다. 혜택피드 이미지 제작 가이드
반환 값
키		-	타입	설명
code			String	결과 코드
message			String	실패 시 결과 메시지
data			Object	성공 시 데이터
		imageHashId	String	이미지 Hash ID
[Example] [Request]
	{ "imageUrl": "https://...", "naverPartnerKey":"{{naverPartnerKey}}", "imageType": "CONTENT" }

	[Example] [Response]
	{ "code": "200", "message": "요청 성공", "data": { "imageHashId": "…” } }

POST /v1/image/upload/file                                                 

이미지 파일 업로드 (uploadFile)

이미지를 로컬 파일로 업로드 합니다.

-H 'Content-Type: multipart/form-data'

-H 'Authorization: Bearer {{accessToken}}'

요청 파라미터
키	-	타입	필수	설명
naverPartnerKey		String	O	파트너키
file		String	O	업로드할 이미지 file
imageType		String	O	"content"/"feed", 디폴트 값인 "content"일 경우 생략이 가능합니다. "content" : 일반적인 이미지 사용시에 설정합니다. (해상도 제한은 없지만 '552X552' 권장), 최대 사이즈 '300 KB' 입니다. "feed" : 혜택 feed 에 표시될 이미지 사용시에 설정합니다. 해상도 '598X300'로 고정되며 그 외의 해상도는 업로드시 에러가 발생합니다. 최대 사이즈 '300 KB' 입니다. 혜택피드 이미지 제작 가이드
반환 값
키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Object	성공 시 데이터
	imageHashId	String	이미지 Hash ID

POST /v1/image/group/upload/url                                            

발송 그룹 이미지 URL 업로드 (groupUploadUrl)

이미지를 URL 로 업로드 합니다.

-H 'Content-Type: application/json'

-H 'Authorization: Bearer {{accessToken}}'

요청 파라미터
키	-	타입	필수	설명
templateGroupKey		String	O	그룹키
imageUrl		String	O	업로드할 이미지의 url
imageType		String	O	"content"/"feed", 디폴트 값인 "content"일 경우 생략이 가능합니다. "content" : 일반적인 이미지 사용시에 설정합니다. (해상도 제한은 없지만 '552X552' 권장), 최대 사이즈 '300 KB' 입니다. "feed" : 혜택 feed 에 표시될 이미지 사용시에 설정합니다. 해상도 '598X300'로 고정되며 그 외의 해상도는 업로드시 에러가 발생합니다. 최대 사이즈 '300 KB' 입니다. 혜택피드 이미지 제작 가이드
반환 값
키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Object	성공 시 데이터
	imageHashId	String	이미지 Hash ID

POST /v1/image/group/upload/file                                           

발송 그룹 이미지 파일 업로드 (groupUploadFile)

이미지를 로컬 파일로 업로드 합니다.

-H 'Content-Type: multipart/form-data'

-H 'Authorization: Bearer {{accessToken}}'

요청 파라미터
키	-	타입	필수	설명
templateGroupKey		String	O	그룹키
file		String	O	업로드할 이미지 file
imageType		String	O	"content"/"feed", 디폴트 값인 "content"일 경우 생략이 가능합니다. "content" : 일반적인 이미지 사용시에 설정합니다. (해상도 제한은 없지만 '552X552' 권장), 최대 사이즈 '300 KB' 입니다. "feed" : 혜택 feed 에 표시될 이미지 사용시에 설정합니다. 해상도 '598X300'로 고정되며 그 외의 해상도는 업로드시 에러가 발생합니다. 최대 사이즈 '300 KB' 입니다. 혜택피드 이미지 제작 가이드
반환 값
키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Object	성공 시 데이터
	imageHashId	String	이미지 Hash ID