巴法文档中心

Appearance

图片接口 ​

本文档介绍巴法云图片存储相关的API接口，支持两种上传方式：二进制传输和form-data格式上传。

图片上传接口一 ​

使用二进制传输方式上传图片到巴法云。

接口信息 ​

  • 请求方法：POST
  • 请求地址：https://images.bemfa.com/upload/v1/upimages.php
  • 默认端口：80（HTTP）

请求头参数 ​

参数类型是否必须说明
Content-Typestring是图片类型，默认image/jpg
Authorizationstring是用户私钥（从控制台获取）
Authtopicstring是主题名称（可在控制台创建）
wechatmsgstring否微信推送消息（可选）
wecommsgstring否企业微信推送消息（可选）
picpathstring否自定义图片链接路径

请求体 ​

请求体为图片的二进制数据。

响应示例 ​

返回JSON格式字符串，包含图片URL地址。

参考教程

图片上传详细教程

图片上传接口二 ​

使用form-data格式上传图片，支持多种图片格式。

接口信息 ​

  • 请求方法：POST
  • 请求地址：https://apis.bemfa.com/vb/api/v1/imagesUpload
  • Content-Type：multipart/form-data

支持的图片格式 ​

jpg、jpeg、png、bmp、gif、tiff、tif、psd、ico、heic

请求参数 ​

参数是否必须类型说明
openID是字符串类型用户私钥
topic是字符串类型主题名称
image是file文件类型图片
wechat否字符串类型是否发送到微信公众号，如果有值，会推送微信
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字符串图片地址

请求示例：

图片上传

获取所有图片主题 ​

获取用户所有包含图片的主题列表。

接口信息 ​

  • 请求方法：GET
  • 请求地址：https://apis.bemfa.com/vb/api/v1/imagesTopic

请求参数 ​

参数类型是否必须说明
openIDstring是用户私钥（从控制台获取）

正常响应：

{
    "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

  • 请求地址：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
    }
}

巴法开放联盟

BeHome Alliance