메인 콘텐츠로 건너뛰기
POST
/
api
/
v1
/
files
/
upload
/
url
URL 파일 업로드
curl --request POST \
  --url https://files-api.evolink.ai/api/v1/files/upload/url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_url": "https://example.com/image.jpg"
}
'
{
  "success": true,
  "code": 200,
  "msg": "파일이 성공적으로 업로드되었습니다",
  "data": {
    "file_id": "file_abc123",
    "file_name": "downloaded.jpg",
    "original_name": "downloaded.jpg",
    "file_size": 2048,
    "mime_type": "image/jpeg",
    "upload_path": "downloads",
    "file_url": "https://files.evolink.ai/downloads/downloaded.jpg",
    "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
file_url
string<uri>
필수

원격 파일 URL

요구사항:

  • 공개적으로 접근 가능한 URL이어야 합니다
  • HTTP 및 HTTPS 프로토콜 지원
  • 시스템이 이 URL에서 파일 콘텐츠를 자동으로 다운로드합니다
  • 요청당 최대 1개 이미지
  • 현재 image/jpeg, image/png, image/gif, image/webp 형식의 파일 업로드만 지원합니다
예시:

"https://example.com/image.jpg"

upload_path
string

사용자 정의 업로드 경로

참고:

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

"downloads"

file_name
string

사용자 정의 파일 이름

참고:

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

"downloaded.jpg"

응답

200 - application/json

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

success
boolean

요청 성공 여부

예시:

true

code
integer

응답 상태 코드

예시:

200

msg
string

응답 메시지

예시:

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

data
object