메인 콘텐츠로 건너뛰기
POST
/
api
/
v1
/
files
/
upload
/
base64
Base64 파일 업로드
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/base64 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "base64_data": "data:image/png;base64,iVBORw0KGgo..."
}
'
{
  "success": true,
  "code": 200,
  "msg": "파일이 성공적으로 업로드되었습니다",
  "data": {
    "file_id": "file_abc123",
    "file_name": "avatar.png",
    "original_name": "avatar.png",
    "file_size": 2048,
    "mime_type": "image/png",
    "upload_path": "avatars",
    "file_url": "https://files.evolink.ai/avatars/avatar.png",
    "download_url": "https://files.evolink.ai/api/v1/files/download/file_abc123",
    "upload_time": "2025-10-09T00:00:00+08:00",
    "expires_at": "2025-10-12T00:00:00+08:00"
  }
}

인증

Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json
base64_data
string
필수

Base64 인코딩된 파일 데이터

지원 형식:

  • Data URL 형식: data:image/png;base64,iVBORw0KGgo...
  • 순수 Base64 인코딩: iVBORw0KGgo...

참고:

  • 요청당 최대 1개 이미지
  • 현재 image/jpeg, image/png, image/gif, image/webp 형식의 파일만 업로드 가능합니다
예시:

"data:image/png;base64,iVBORw0KGgo..."

upload_path
string

사용자 정의 업로드 경로

참고:

  • 지정하지 않으면 시스템이 파일 유형에 따라 자동으로 분류합니다
예시:

"avatars"

file_name
string

사용자 정의 파일 이름

참고:

  • 지정하지 않으면 시스템이 자동으로 고유한 파일 이름을 생성합니다
예시:

"avatar.png"

응답

200 - application/json

파일이 성공적으로 업로드되었습니다

success
boolean

요청 성공 여부

예시:

true

code
integer

응답 상태 코드

예시:

200

msg
string

응답 메시지

예시:

"파일이 성공적으로 업로드되었습니다"

data
object