1. 이미지

1.1 한 개의 이미지(프로필, 상품)

API

Req

프로필 등록, 프로필 수정, 상품 등록 페이지 등 이미지 등록이 필요한 페이지에서 사용하는 API입니다. 이미지 등록이 필요한 페이지에서는 우선 서버에 이미지를 전송하면 숫자로 이루어진 filename을 포함하는 응답을 받을 수 있습니다. 그 filename을 다른 정보와 함께 서버에 전송해 줍니다.

*10MB 이상의 이미지는 업로드 할 수 없습니다.

예시 ) 프로필 등록 페이지에서의 사용 방법

이미지를 서버에 전송합니다. (POST /image/uploadfile)

숫자로 이루어진 filename을 응답받습니다. (2.png → 1640066364747.png)

다른 정보와 함께 서버에 전송합니다. (POST /user)

filename은 “image”에 문자열로 전송합니다.

{
		"user": {
				"_id": String,
				"email": String,
				"hearts": [],
				"isfollow": [],
				"following": [],
				"follower": [],
				"password": String,
				"username": String,
				"accountname": String,
				"intro": String,
				"image": String // 예시) https://mandarin.api.weniv.co.kr/filename.확장자
		}
}
JSON
복사

1.1 한 개의 이미지(프로필, 상품)

API

POST /image/uploadfile
JavaScript
복사
method, 전송 url

Req

key(name) : image (type을 file로 지정)
value : 이미지 파일(*.jpg, *.gif, *.png, *.jpeg, *.bmp, *.tif, *.heic)
//formdata의 키와 벨류를 의미합니다.
JSON
복사
body(form-data)

{
	"Content-type" : "multipart/form-data"
}
JSON
복사
header

Res

// SUCCESS
{
		"fieldname": "image",
		"originalname": "2.png",
		"encoding": "7bit",
		"mimetype": "image/png",
		"destination": "uploadFiles/",
		"filename": "1640066364747.png",
		"path": "uploadFiles/1640066364747.png",
		"size": 47406
}

// FAIL
// 이미지 파일(*.jpg, *.gif, *.png, *.jpeg, *.bmp, *.tif, *.heic) 확장자명이 다를 때
이미지 파일만 업로드가 가능합니다.
JSON
복사

1.2 여러개의 이미지(포스트)

여러개의 이미지를 등록하는 방법도 한개의 이미지를 등록하는 방법과 동일합니다. 우선 이미지를 서버에 전송하고 숫자로 이루어진 filename을 응답받습니다. 단, 이때 응답 받은 filename을 서버에 다시 전송할 때는 하나의 문자열로 전송되어야 합니다.

예를 들어, “1640066364747.png”와 “1640066364748.png”를 동시에 전송할 때는 둘을 합친 문자열로 전송해야 합니다. 이미지 이름을 합칠 때는 따옴표나 다른 기호를 통해 구분하여 합치면 나중에 이미지를 가져올 때 쉽게 사용할 수 있습니다.

“1640066364747.png,1640066364748.png” 이렇게 ,(따옴표)로 구분하여 문자열을 전송한 후 이미지를 불러올 때는 따옴표를 기준으로 split하여 사용할 수 있습니다. 편한 방법을 통해 문자열을 분리하여 사용해 보세요.

API

여러 이미지는 3개까지 받을 수 있습니다.

POST /image/uploadfiles
JavaScript
복사
method, 전송 url

Req

key : image(type을 file로 지정)
value : 이미지 파일(*.jpg, *.gif, *.png, *.jpeg, *.bmp, *.tif, *.heic)
JSON
복사
body(form-data)

Res

// SUCCESS
{
		"fieldname": "image",
		"originalname": "2.png",
		"encoding": "7bit",
		"mimetype": "image/png",
		"destination": "uploadFiles/",
		"filename": "1640066364747.png",
		"path": "uploadFiles/1640066364747.png",
		"size": 47406
}

// FAIL
// 이미지 파일(*.jpg, *.gif, *.png, *.jpeg, *.bmp, *.tif, *.heic) 확장자명이 다를 때
이미지 파일만 업로드가 가능합니다.

// 3개 초과의 이미지를 업로드 했을 때
3개 이하의 파일을 업로드 하세요.
JSON
복사

1.3 이미지 보기

API

GET https://mandarin.api.weniv.co.kr/filename.이미지 확장자
JavaScript
복사
method, 전송 url

Res

JSON
복사

// FAIL
{
		"status":404
}
JSON
복사