メインコンテンツへスキップ
POST
/
api
/
upload
/
file
multipart/form-data 経由でファイルをアップロード
curl --request POST \
  --url https://files-api.sinancode.com/api/upload/file \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "url": "https://upload-tmp.sinancode.com/uploads/user123/abc123def456.png",
  "cn_url": "https://beijing-user-upload-tmp.tos-cn-beijing.volces.com/uploads/user123/abc123def456.png",
  "key": "uploads/user123/abc123def456.png",
  "md5": "d41d8cd98f00b204e9800998ecf8427e",
  "size": 12345,
  "content_type": "image/png",
  "expires_at": "2024-01-17T00:00:00.000Z"
}
標準の multipart/form-data エンコーディングを使用してクラウドストレージにファイルをアップロードします。 主な特徴:
  • 標準形式 - すべての HTTP クライアントと互換性のある multipart/form-data エンコーディングを使用
  • 大容量ファイルサポート - 最大 50MB のファイルをサポート
  • 自動検出 - ファイルの MIME タイプを自動検出
  • デュアルアクセス - グローバルと中国の両方のアクセス URL を返却

承認

Authorization
string
header
必須

api.sinancode.com から取得した認証トークン

ボディ

multipart/form-data
file
file
必須

アップロードするファイル(最大 50MB)

レスポンス

ファイルが正常にアップロードされました

url
string<uri>
必須

アップロードされたファイルにアクセスするための公開 URL(グローバル)

:

"https://upload-tmp.sinancode.com/uploads/user123/abc123def456.png"

cn_url
string<uri>
必須

アップロードされたファイルにアクセスするための公開 URL(中国)

:

"https://beijing-user-upload-tmp.tos-cn-beijing.volces.com/uploads/user123/abc123def456.png"

key
string
必須

アップロードされたファイルのストレージキー

:

"uploads/user123/abc123def456.png"

md5
string
必須

ファイル内容のハッシュ(SHA-256 切り捨て)

:

"d41d8cd98f00b204e9800998ecf8427e"

size
integer
必須

ファイルサイズ(バイト単位)

:

12345

content_type
string
必須

ファイルの MIME タイプ

:

"image/png"

expires_at
string<date-time>
必須

ファイルの有効期限(ISO 8601)

:

"2024-01-17T00:00:00.000Z"