Base Image Upload API 文档
图片上传api
接口信息
- 接口地址:
{your-site-url}/api/skill/base-image/upload
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
- 请求方式:
POST
- Content-Type:
application/json
认证
请求头中需要携带 skill-access-token：
| Header |
值 |
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (Body - JSON)
| 字段 |
类型 |
必填 |
说明 |
image_base64encode |
string |
✅ 必填 |
图片的 Base64 编码字符串。注意：不要带 data:image/png;base64, 前缀，只传纯 base64 字符串部分。支持的图片格式：jpg、gif、png、webp、avif |
image_name |
string |
✅ 必填 |
图片名称，如 test.jpg、6666.png。支持的图片格式：jpg、gif、png、webp、avif |
group_type |
string |
✅ 必填 |
图片业务类型，可选值见下方枚举 |
group_type 枚举值
| 值 |
说明 |
product |
商品图片 |
category |
商品专辑图片 |
blog_article |
博客文章图片 |
editor |
编辑器里面的图片 |
common |
通用图片 |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/base-image/upload' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"image_base64encode": "iVBORw0KGgo...（base64字符串，不含 data:image/png;base64, 前缀）",
"image_name": "6666.png",
"group_type": "product"
}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"name": "a5f51aa28b9c58e7f9b1943b584b0883.png",
"path": "/product/15/image/2026/05/05/a5f51aa28b9c58e7f9b1943b584b0883.png",
"width": 1200,
"height": 468,
"ratio": 2.56,
"group_type": "product",
"ext": "png",
"size": 45727,
"md5": "ec6b3c25bfb6282d0a4ec200db09f8f3",
"year": "2026",
"month": "05",
"image_base_url": "https://cdn12.fecmall.com"
},
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码，200 表示成功 |
message |
String |
执行结果的文字描述 |
data |
Object |
返回数据 |
data 子字段
| 字段 |
类型 |
说明 |
name |
String |
图片名称（服务端生成的文件名） |
path |
String |
图片存储路径 |
width |
Number |
图片宽度（像素） |
height |
Number |
图片高度（像素） |
ratio |
Number |
宽高比 |
group_type |
String |
图片业务类型 |
ext |
String |
图片文件后缀 |
size |
Number |
图片大小（字节） |
md5 |
String |
图片 MD5 编码 |
year |
String |
年 |
month |
String |
月 |
image_base_url |
String |
图片访问的基础 URL，通过 image_base_url + path 即可得到图片的完整访问 URL |
注意事项
image_base64encode 字段只需传入纯 base64 字符串，不要带 data:image/png;base64, 等前缀image_name 需包含正确的文件扩展名（如 .png、.jpg）group_type 必须从枚举值中选择，否则可能导致上传失败- 上传成功后，服务端会重新命名文件（返回的
name 可能与传入的 image_name 不同）
- 完整的图片访问链接通过
image_base_url + path 拼接获得。例如：https://cdn12.fecmall.com + /product/15/image/2026/05/13/xxx.png