上传图片或文件
接口
POST /v1/media-assets请求必须使用 multipart/form-data,上传文件字段名必须是 file。
可选字段:
curl 示例
curl -X POST "https://drop.maomaotoken.com/v1/media-assets" \\
-H "X-Media-Upload-Key: mu_xxxxxxxxxxxx" \\
-F "file=@/path/to/image.png" \\
-F "expires_in=259200"259200 表示保存 3 天。
实际可填写的最长时间以管理员为该图床 Key 配置的上限为准。
也可以使用 Authorization 请求头:
curl -X POST "https://drop.maomaotoken.com/v1/media-assets" \\
-H "Authorization: Bearer mu_xxxxxxxxxxxx" \\
-F "file=@/path/to/image.png"成功响应
{
"success": true,
"data": {
"asset_id": "asset_01jabcxyz",
"original_name": "image.png",
"media_type": "image",
"content_type": "image/png",
"size": 245678,
"status": "ready",
"public_url": "https://drop.maomaotoken.com/media-assets/asset_01jabcxyz",
"created_at": 1788000000,
"expires_at": 1788259200
}
}上传成功后,保存响应中的 data.public_url 这个地址就是可以给其他系统或网页使用的公网素材地址。
建议同时保存 asset_id 和 expires_at,前者用于查询或删除,后者用于处理过期提醒。
在网页中使用
<img src="https://drop.maomaotoken.com/media-assets/asset_01jabcxyz" alt="上传的图片">视频可以直接作为播放器地址:
<video controls src="https://drop.maomaotoken.com/media-assets/asset_01jabcxyz"></video>公网素材地址不需要携带图床 Key。
图床 Key 只应出现在你自己的服务端请求中。