HomeAboutMeBlogGuest
© 2025 Sejin Cha. All rights reserved.
Built with Next.js, deployed on Vercel
♥️
2기 최종 프로젝트 팀별 공간
/
🌳
[팀 05] Forest
/
🪐
BE WorkSpace
/
🗯️
API 명세
/
🥏
/api/v1/images
🥏

/api/v1/images

HTTP 메서드
POST
contents-type
multipart-formdata
비고
이미지 업로드
연관된 페이지
속성
⏳ 유저 스토리

[Description]

이미지 업로드
  • 현재 png, jpg만 확장자로 등록해 두었는데, 추가하실 것 있으면 의견 주세요!

[Request]

  • Multipart-formdata 방식으로 이미지 파일을 보냅니다.
 

요청 / 응답 예시(Postman)

notion image

[Response]

Body
key
type
설명
비고
id
number
이미지 id
originalFIleName
String
파일 다운로드 시에, 유저 경험을 위해 원본 파일명을 제공
url
String
이미지가 저장된 url
프론트엔드 분들 입장에서 이미지를 보여주기 위해 사용하시면 되는 부분입니다.
{ "id": 1, "originalFileName": "favi.png", "url": "https://s3.ap-northeast-2.amazonaws.com/team-05-storage/static/42412f6e-41d8-495e-851c-316435bf4976.png" }
  • 이미지 출력에는 url을 이용해주시고,
  • 글 작성 등, 관련 객체 생성 요청 등에는 위의 이미지 id값을 보내주시면 됩니다.
 

이미지 업로드 성공 시

상태 코드

200 OK

이미지 업로드 실패 시

실패 시 응답
상태코드
메시지
400-BAD_REQUEST
비어 있는 파일이기에 저장이 불가합니다.
400-BAD_REQUEST
지원하지 않는 파일 확장자입니다.
500-INTERNAL_SERVER_ERROR
파일을 저장하는 과정에서 입출력 에러가 발생하였습니다.