Skip to content

upload-api.md

Latest commit

 

History

History
98 lines (72 loc) · 2.08 KB

upload-api.md

File metadata and controls

98 lines (72 loc) · 2.08 KB

Upload API

이미지 업로드 API (Supabase Storage)

핵심 원칙

  • 로그인한 사용자만 업로드 가능
  • 허용 형식: JPEG, PNG, GIF, WEBP
  • 최대 파일 크기: 10MB
  • 업로드된 파일은 Supabase Storage images 버킷에 저장

Endpoints

Method Endpoint Auth Description
POST /upload Required 이미지 업로드
GET /upload/storage OWNER Storage 이미지 목록 조회 (페이지네이션)

Request & Response

POST /upload

multipart/form-data 형식으로 파일을 전송한다. 업로드 시 sharp 기반 이미지 최적화 (리사이징 + WEBP 변환 등)가 자동 적용된다.

Content-Type: multipart/form-data
Field name: file

// Response (200)
{
  "success": true,
  "url": "https://zrkselfyyqkkqcmxhjlt.supabase.co/storage/v1/object/public/images/posts/a1b2c3d4-filename.webp"
}

GET /upload/storage

Supabase Storage images 버킷에 저장된 이미지 목록을 페이지네이션으로 반환한다. 응답은 30초간 in-memory 캐시되며, 새 업로드 발생 시 캐시는 무효화된다.

Query Parameters:
- page: number (default: 1, 페이지당 20개)

// Response (200)
{
  "success": true,
  "data": [
    {
      "name": "posts/a1b2c3d4-filename.webp",
      "url": "https://zrkselfyyqkkqcmxhjlt.supabase.co/storage/v1/object/public/images/posts/a1b2c3d4-filename.webp",
      "size": 102400,
      "createdAt": "2024-01-01T00:00:00.000Z"
    }
  ],
  "hasNext": true,
  "nextPage": 2,
  "total": 42
}

파일 저장 경로

images/posts/{uuid8자리}-{안전한파일명}

파일명의 특수문자는 _로 치환된다.

제약 사항

항목 값
허용 MIME 타입 image/jpeg, image/png, image/gif, image/webp
최대 파일 크기 10MB
인증 로그인 필수

에러 응답

Status Description
400 파일 미첨부, 지원하지 않는 형식, 크기 초과, 업로드 실패
401 인증 필요