Appearance
简介
图片上传有两个接口，接口一使用图片二进制传输上传，接口二使用常见的form-data格式提交上传。
图片上传接口一
推送图片到巴法云，二进制传输。
API: https://images.bemfa.com/upload/v1/upimages.phpPOST接口推送数据，默认端口都是80
http头部字段：
| 参数 | 是否必须 | 参数值 | 说明 |
|---|---|---|---|
| Content-Type | 是 | image/jpg | 默认image/jpg |
| Authorization | 是 | 用户私钥 | 用户私钥，巴法云控制台获取 |
| Authtopic | 是 | 主题名 | 主题名，可在控制台创建并获取 |
| wechatmsg | 否 | 自定义消息 | 自定义需要发送到微信的消息，如果携带此字段，图片会推送到微信公众号 |
| wecommsg | 否 | 自定义消息 | 自定义需要发送到企业微信的消息，如果携带此字段，图片会推送到企业微信和微信 |
| picpath | 否 | 自定义图片链接 | 自定义图片上传的链接，如果携带此字段，链接是密钥+主题的md5的值+picpath值 |
http 消息体：消息体为图片的二进制格式
正常响应：
返回json格式的字符串，内含图片url地址。
教程：点击跳转
图片上传接口二
支持的图片格式：jpg、jpeg、png、bmp、gif、tiff、tif、psd、ico、heic。
form-data格式
POST接口
https://apis.bemfa.com/vb/api/v1/imagesUploadbody参数
| 参数 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| openID | 是 | 字符串类型 | 用户私钥 |
| topic | 是 | 字符串类型 | 主题名称 |
| image | 是 | file文件类型 | 图片 |
| 否 | 字符串类型 | 是否发送到微信公众号，如果有值，会推送微信 | |
| pash | 否 | 字符串类型 | 是否自定义地址 |
正确返回：
{
"code": 0,
"msg": "success",
"data": {
"url": "https://img2.bemfa.com/2e828657ec4eee3f32898b5dd8fc2d09-cd9987d53e71a013c87c56e4175ac48d-1714806668.jpg",
"topic": "mypicture",
"time": "2024-05-04 15:11:09"
}
}| 参数 | 类型 | 说明 |
|---|---|---|
| topic | 字符串 | 主题值 |
| time | 字符串 | 上传时间 |
| url | 字符串 | 图片地址 |
请求示例：
获取所有图片主题
API: https://apis.bemfa.com/vb/api/v1/imagesTopic请求字段：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| openID | 是 | 用户私钥，巴法云控制台获取 |
正常响应：
{
"code": 0,
"msg": "success",
"data": {
"array": [
{
"topic": "wetopic",
"name": "",
"url": "",
"time": "1970-01-01 08:00:00"
},
{
"topic": "mypicture",
"name": "",
"url": "https://img2.bemfa.com/2e828657ec4eee3f32898b5dd8fc2d09-ac5dbb3d41a9d86c366e9fa5844f3a5b-1731213394.jpg",
"time": "2024-11-10 12:36:34"
}
]
}
}array 字段说明：
| 字段 | 说明 |
|---|---|
| topic | 图片主题 |
| name | 主题昵称 |
| url | 最新图片地址 |
| time | 最新图片上传时间 |
请求体示例：
http://apis.bemfa.com/vb/api/v1/imagesTopic?openID=4d9ec352e0376f2110a0c601a2857225
获取单个主题图片
GET接口
https://apis.bemfa.com/vb/api/v1/imagesTopicList请求字段：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| openID | 是 | 字符串，用户私钥，巴法云控制台获取 |
| topicID | 是 | 字符串，图片主题 |
| id | 否 | 整形，默认0，如果不是空，表示获取小于id值的图片，如果是0，获取最新图片 |
| time | 否 | 字符串，默认""即可，如果不是空，格式是2006-01-02 15:04:05，表示获取这个时间之前的图片 |
默认单次获取50条
正常响应：
{
"code": 0,
"msg": "success",
"data": {
"array": [
{
"id": 22847611,
"url": "https://img2.bemfa.com/2e828657ec4eee3f32898b5dd8fc2d09-ac5dbb3d41a9d86c366e9fa5844f3a5b-1731213394.jpg",
"time": "2024-11-10 12:36:34"
},
{
"id": 22847609,
"url": "https://img2.bemfa.com/2e828657ec4eee3f32898b5dd8fc2d09-4533d1f48966c6798a335e62e76e1f6d-1731213382.jpg",
"time": "2024-11-10 12:36:22"
}
]
}
}array 字段说明：
| 字段 | 说明 |
|---|---|
| id | 图片ID值 |
| url | 图片地址 |
| time | 图片上传时间 |
删除图片
POST接口
JSON格式 数据类型 "Content-Type": "application/json; charset=utf-8"
API: https://apis.bemfa.com/vb/api/v1/deleteFiles
| 参数 | 是否必须 | 说明 |
|---|---|---|
| uid | 是 | 用户私钥，巴法云控制台获取 |
| topic | 是 | 主题名 |
| images | 是 | json数组,数组长度最小为1,最大99 |
请求体示例：
{
"uid":"4d9ec352e0376f2110a0c601a2857225",
"topic":"mypicture",
"images":[
"https://img2.bemfa.com/2e828657ec4eee3f32898b5dd8fc2d09-c67bda0c2c326b93e579f3bd5252d8cb-1686193353.jpg",
"https://img2.bemfa.com/2e828657ec4eee3f32898b5dd8fc2d09-4602e6d39b9fe466b40cad6365c0d14c-1686193349.jpg"
]
}正确返回：
{
"code": 0,
"message": "OK",
"data": {
"data": 0
}
}