上传图片 - Lsky Pro+

请求参数

Header 参数

Accept

string

可选

默认值:

application/json

Body 参数multipart/form-data

file

二进制图片文件

必需

示例值:

file:///Users/wispx/Downloads/真正的程序员.png

storage_id

integer

储存ID

必需

示例值:

1

album_id

integer

相册，登录用户有效

可选

expired_at

string

可选

到期时间(yyyy-MM-dd HH:mm:ss)

tags[]

array[string]

标签，登录用户有效

可选

示例值:

["街头摄影","城市建筑"]

is_public

boolean

可选

是否公开图片，默认 false，登录用户有效

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://127.0.0.1:8000/api/v2/upload' \
--header 'Accept: application/json' \
--form 'file=@"/Users/wispx/Downloads/真正的程序员.png"' \
--form 'storage_id="1"' \
--form 'album_id=""' \
--form 'expired_at=""' \
--form 'tags[]="街头摄影"' \
--form 'tags[]="城市建筑"' \
--form 'is_public=""'

返回响应

🟢200成功

application/json

Body

status

string

必需

message

string

必需

data

object

必需

id

integer

图片ID

必需

name

string

必需

图片名称(不含拓展名)

filename

string

文件名称

必需

pathname

string

物理路径

必需

mimetype

string

文件类型

必需

extension

string

拓展名

必需

md5

string

md5值

必需

sha1

string

sha1值

必需

ip_address

string

上传ip地址

必需

public_url

string

图片访问地址

必需

width

integer

宽度

必需

height

integer

高度

必需

time

integer

必需

示例

{
  "status": "success",
  "message": "success",
  "data": {
    "id": 23,
    "name": "落魄程序员在线炒粉",
    "filename": "落魄程序员在线炒粉.gif",
    "pathname": "20240627/6a39702c8347047c6749854a40831de0.gif",
    "mimetype": "image/gif",
    "extension": "gif",
    "md5": "6a39702c8347047c6749854a40831de0",
    "sha1": "570bdc9ae184db710ee74824a15725d5ed3db589",
    "width": 282,
    "height": 282,
    "ip_address": "127.0.0.1",
    "public_url": "http://localhost/20240627/6a39702c8347047c6749854a40831de0.gif"
  },
  "time": 1719468654
}

🟠422参数错误

🟠429超出频率限制