가지마켓 API 명세

const url = "https://api.mandarin.weniv.co.kr"; try{ const res = await fetch(url+"/user/login/", { method: "POST", headers: { "Content-Type": "application/json", }, body : JSON.stringify({ "user":{ "email": emailAddr.value, "password": pw.value } }) }); const resJson = await res.json(); console.log(resJson); } catch(err){ console.error(err); }

const url = "https://mandarin.api.weniv.co.kr"; try { const response = await fetch(url+"/image/uploadfiles", { method: "POST", body : formData }); const data = await response.json(); for(let i of data) { name.push(i["filename"]); } if(name.length > 1) { return name.join(","); } else { return name[0]; } } catch (err) { console.error(err); }

POST /image/uploadfile

key(name) : image value : 이미지 파일(*.jpg, *.gif, *.png, *.jpeg, *.bmp, *.tif, *.heic) //formdata의 키와 벨류를 의미합니다.

{ "Content-type" : "multipart/form-data" }

// 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) 확장자명이 다를 때 이미지 파일만 업로드가 가능합니다.

POST /image/uploadfiles

key : image value : 이미지 파일(*.jpg, *.gif, *.png, *.jpeg, *.bmp, *.tif, *.heic)

// 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개 이하의 파일을 업로드 하세요.

GET https://api.mandarin.weniv.co.kr/filename.이미지 확장자

# url 그대로 사용 https://api.mandarin.weniv.co.kr/filename.이미지 확장자

// FAIL { "status":404 }

POST /user

{ "user": { "username": String*, "email": String*, "password": String*, "accountname": String*, "intro": String, "image": String // 예시) https://api.mandarin.weniv.co.kr/1641906557953.png } }

{ "Content-type" : "application/json" }

// SUCCESS { "message": "회원가입 성공", "user": { "_id": String, "username": String, "email": String, "accountname": String, "intro": String, "image": String, } } // FAIL // email, password, accountname, username 중 하나라도 작성하지 않을 경우 필수 입력사항을 입력해주세요. // password를 6자 이상 입력하지 않을 경우 비밀번호는 6자 이상이어야 합니다. // eamil 형식이 잘못될 경우 잘못된 이메일 형식입니다. // 가입된 email일 경우 이미 가입된 이메일 주소입니다. // accountname에 지정된 문자 이외의 문자가 들어갈 경우 영문, 숫자, 밑줄, 마침표만 사용할 수 있습니다. // 가입된 accountname일 경우 이미 사용중인 계정 ID입니다.

POST /user/login

{ "user":{ "email": String, "password": String } }

{ "Content-type" : "application/json" }

// SUCCESS { "user": { "_id": String, "username": String, "email": String, "accountname": String, "image": String, "token": String } } // FAIL // email, password를 입력하지 않을 때 이메일 또는 비밀번호를 입력해주세요. // email를 입력하지 않을 때 이메일을 입력해주세요. // password를 입력하지 않을 때 비밀번호를 입력해주세요. // email, password를 일치하지 않을 때 { "message": "이메일 또는 비밀번호가 일치하지 않습니다.", "status": 422 }

GET /user/myinfo

{ "Authorization" : "Bearer {token}" }

// SUCCESS [ { "user": { "_id": String, "username": String, "accountname": String, "image": String, "isfollow": false, "following": [], "follower": [], "followerCount": 0, "followingCount": 0 } } ]

POST /user/emailvalid

{ "user":{ "email": String } }

{ "Content-type" : "application/json" }

// SUCCESS // 사용 가능한 이메일인 경우 { "message": "사용 가능한 이메일 입니다." } // 가입한 이메일이 있는 경우 { "message": "이미 가입된 이메일 주소 입니다." } f // FAIL { "message": "잘못된 접근입니다." }

POST /user/accountnamevalid

{ "user":{ "accountname": String } }

{ "Content-type" : "application/json" }

// SUCCESS // 사용 가능한 계정ID인 경우 { "message": "사용 가능한 계정ID 입니다." } // 가입한 계정ID가 있는 경우 { "message": "이미 가입된 계정ID 입니다." } // FAIL { "message": "잘못된 접근입니다." }

PUT /user

{ "user":{ "username": String, "accountname": String, "intro": String, "image": String } }

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "user": { "_id": String, "username": String, "accountname": String, "intro": String, "image": String, "following": [], "follower": [], "followerCount": Number, "followingCount": Number } } // FAIL // 가입된 accountname일 경우 이미 사용중이 계정 ID입니다.

GET /profile/:accountname

{ "Authorization" : `Bearer ${token}`, "Content-type" : "application/json" }

// SUCCESS { "profile": { "_id": String, "username": String, "accountname": String, "intro": String, "image": String, "isfollow": Boolean, "following": [], "follower": [], "followerCount": Number, "followingCount": Number } } // FAIL // 계정이 존재하지 않을 때 해당 계정이 존재하지 않습니다.

POST /profile/:accountname/follow

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS // follow 한 사용자의 프로필 { "profile": { "_id": String, "username": String, "accountname": String, "intro": String, "image": String, "isfollow": Boolean, "following": [], "follower": [ "접속한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } } // FAIL // 계정이 존재하지 않을 때 해당 계정이 존재하지 않습니다. // 자신을 팔로우하려 할 때 { "message": "자기 자신을 팔로우 할 수 없습니다." }

DELETE /profile/:accountname/unfollow

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

GET /profile/:accountname/following // paging limit skip GET /profile/:accountname/following?limit=Number&skip=Number

{ "Authorization" : `Bearer ${token}`, "Content-type" : "application/json" }

// SUCCESS // following 한 사용자가 있을 때 [ { "_id": String, "username": String, "accountname": String, "intro": String, "image": String, "isfollow": Boolean, "following": [], "follower": [ "접속한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } ] // following 한 사용자가 없을 때 [] // FAIL // 계정이 존재하지 않을 때 해당 계정이 존재하지 않습니다.

GET /profile/:accountname/follower // paging limit skip GET /profile/:accountname/follower/?limit=Number&skip=Number

{ "Authorization" : `Bearer ${token}`, "Content-type" : "application/json" }

// SUCCESS // follower 한 사용자가 있을 때 [ { "_id": String, "username": String, "accountname": String, "intro": String, "image": String, "isfollow": Boolean, "following": [], "follower": [ "접속한 사용자의 id" ], "followerCount": 1, "followingCount": 0 }, { "_id": String, "username": String, "accountname": String, "intro": String, "image": String, "isfollow": Boolean, "following": [], "follower": [ "접속한 사용자의 id" ], "followerCount": 1, "followingCount": 0 }, ] // follower 한 사용자가 없을 때 [] // FAIL // 계정이 존재하지 않을 때 해당 계정이 존재하지 않습니다.

GET /user/searchuser/?keyword=keyword

{ "Authorization" : `Bearer ${token}`, "Content-type" : "application/json" }

// SUCCESS [ { "_id": String, "username": String, "accountname": String, "following": [], "follower": [], "followerCount": Number, "followingCount": Number } ]

POST /post

{ "post": { "content": String, "image": String //"imageurl1, imageurl2" 형식으로 } }

{ "Authorization" : `Bearer ${token}`, "Content-type" : "application/json" }

// SUCCESS { "post": [ { "id": String, "content": String, "image": String, "createdAt": String, "updatedAt": String, "hearted": false, "heartCount": 0, "commentCount": 0, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "following": [], "follower": [ "follower id" ], "followerCount": 1, "followingCount": 0 } } ] } // FAIL // 내용 또는 이미지를 입력하지 않을 때 내용 또는 이미지를 입력해주세요.

GET /post/feed // paging limit skip GET /post/feed/?limit=Number&skip=Number

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS // follow 한 사용자가 있을 때 { "posts": [ { "id": String, "content": "안녕하세요. 2 입니다.", "image": String, "createdAt": String, "updatedAt": String, "hearted": false, "heartCount": 0, "commentCount": 0, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "following": [], "follower": [ "follower id" ], "followerCount": 1, "followingCount": 0 } } ] } // follow 한 사용자가 없을 때 { "posts": [] }

GET /post/:accountname/userpost // paging limit skip GET /post/:accountname/userpost/?limit=Number&skip=Number

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "post": [ { "id": String, "content": "안녕하세요. 2 입니다.", "image": String, "createdAt": String, "updatedAt": String, "hearted": false, "heartCount": 0, "commentCount": 0, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "following": [], "follower": [ "follower id" ], "followerCount": 1, "followingCount": 0 } } ] } // 해당 계정의 게시물이 존재하지 않을 때 { "post":[] } // FAIL // 해당 계정이 존재하지 않을 때 해당 계정이 존재하지 않습니다.

GET /post/:post_id

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "post": [ { "id": String, "content": String, "image": String, "createdAt": String, "updatedAt": String, "hearted": false, "heartCount": 0, "commentCount": 0, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "following": [], "follower": [ "follower id" ], "followerCount": 1, "followingCount": 0 } } ] } // FAIL // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다.

PUT /post/:post_id

{ "post": { "content": String, "image": String } }

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "post": [ { "id": String, "content": String, "image": String, "createdAt": String, "updatedAt": String, "hearted": false, "heartCount": 0, "commentCount": 0, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "following": [], "follower": [ "follower id" ], "followerCount": 1, "followingCount": 0 } } ] } // FAIL // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다. // 다른 사용자가 해당 게시물을 수정할 경우 잘못된 요청입니다. 로그인 정보를 확인하세요.

DELETE /post/:post_id

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS 삭제되었습니다. // FAIL // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다. // 다른 사용자가 해당 게시물을 수정할 경우 잘못된 요청입니다. 로그인 정보를 확인하세요.

POST /post/:post_id/report

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "report": { "post": "포스트 id" } } // FAIL // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다.

POST /post/:post_id/heart

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "post": { "id": String, "content": String, "createdAt": String, "updatedAt": String, "hearted": true, "heartCount": 1, "commentCount": 0, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "intro": "2", "image": "2", "following": [], "follower": [ "팔로워 한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } } } // FAIL // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다.

DELETE /post/:post_id/unheart

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "post": { "id": "61c0252b8ec189519824a9b1", "content": "2@naver.com", "createdAt": "2021-12-20T06:39:39.929Z", "updatedAt": "2021-12-20T08:05:12.727Z", "hearted": false, "heartCount": 0, "commentCount": 0, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "intro": "2", "image": "2", "following": [], "follower": [ "팔로워 한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } } } // FAIL // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다.

POST /post/:post_id/comments

{ "comment":{ "content":String } }

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "comment": { "id": Sting, "content": Sting, "createdAt": Sting, "author": { "_id": "작성자 id", "username": "1", "accountname": "1", "intro": "1", "image": "1", "following": [], "follower": [], "followerCount": 0, "followingCount": 0 } } } // FAIL // 게시물이 존재하지 않을 때 존재하지 않는 게시글입니다. // 댓글을 입력하지 않을 때 댓글을 입력해주세요.

// 기본값은 10개만 불러옵니다. GET /post/:post_id/comments // paging limit skip GET /post/:post_id/comments/?limit=Number&skip=Number

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS // 댓글이 존재하는 경우 { "comment": [ { "id": String, "content": String, "createdAt": "2021-12-20T06:10:26.803Z", "author": { "_id": "작성자 id", "username": "1", "accountname": "1", "intro": "1", "image": "1", "following": [], "follower": [], "followerCount": 0, "followingCount": 0 } } ] } // 댓글이 존재하지 않는 경우 { "comment": [] } // FAIL // 게시물이 존재하지 않을 때 존재하지 않는 게시글입니다.

DELETE /post/:post_id/comments/:comment_id

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS 댓글이 삭제되었습니다. // FAIL // 다른 사용자의 댓글을 삭제하려고 할 때 댓글 작성자만 댓글을 삭제할 수 있습니다. // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다. // 댓글이 존재하지 않을 때 댓글이 존재하지 않습니다.

POST /post/:post_id/comments/:comment_id/report

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "report": { "comment": "댓글 id" } } // FAIL // 게시글이 존재하지 않을 때 존재하지 않는 게시글입니다. // 댓글이 존재하지 않을 때 댓글이 존재하지 않습니다.

POST /product

{ "product":{ "itemName": String, "price": Number,//1원 이상 "link": String, "itemImage": String } }

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "product": { "id": String, "itemName": String, "price": Number, "link": String, "itemImage": String, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "intro": "2", "image": "2", "following": [], "follower": [ "팔로워 한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } } } // FAIL // itemName, price, link, itemImage 중 하나라도 입력하지 않았을 때 필수 입력사항을 입력해주세요. // price를 String으로 입력했을 때 가격은 숫자로 입력하셔야 합니다.

GET /product/:accountname // paging limit skip GET /product/:accountname/?limit=Number&skip=Number

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

회// SUCCESS // 상품이 있을 때 { "data" : Number, "product": [ { "id": String, "itemName": String, "price": Number, "link": String, "itemImage": String, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "intro": "2", "image": "2", "following": [], "follower": [ "팔로워 한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } } ] } // 상품이 없을 때 { "data" : 0, "product": [] }

GET /product/detail/:product_id

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "product":{ "id": String, "itemName": String, "price": Number, "link": String, "itemImage": String, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "intro": "2", "image": "2", "following": [], "follower": [ "팔로워 한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } } }

PUT /product/:product_id

{ "product": { "itemName": String, "price": Number, "link": String, "itemImage": String } }

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS { "product": { "id": String, "itemName": String, "price": Number, "link": String, "itemImage": String, "author": { "_id": "작성자 id", "username": "2", "accountname": "2", "intro": "2", "image": "2", "following": [], "follower": [ "팔로워 한 사용자의 id" ], "followerCount": 1, "followingCount": 0 } } } // FAIL // 상품이 없을 때 등록된 상품이 없습니다. // 상품을 등록한 사용자가 아닐 때 잘못된 요청입니다. 로그인 정보를 확인하세요.

DELETE /product/:product_id

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// SUCCESS 삭제되었습니다. // FAIL // 상품이 없을 때 등록된 상품이 없습니다. // 상품을 등록한 사용자가 아닐 때 잘못된 요청입니다. 로그인 정보를 확인하세요.

GET user/checktoken

{ "Authorization" : "Bearer {token}", "Content-type" : "application/json" }

// 토큰이 유효한 경우 { "isValid":true } // 토큰이 유효하지않은 경우 { "isValid":false }