自定义图片黑库接口
更新时间：2021-03-01
创建自定义图片黑库
创建自定义图片黑库
请求语法
Plain Text
1POST /v<version>/image/lib HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>
5content-type: application/json请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| name | String | 自定义图片黑库名称，最长40个字符 | 是 |
| description | String | 描述，最大支持256字符 | 否 |
请求示例
Plain Text
1POST /v1/image/lib HTTP/1.1
2host: vcr.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>
5x-bce-date: <bce-authorization-utc-date>
6
7{
8 "name": "test",
9 "description": "image lib description"
10}响应参数
无
响应示例
Plain Text
1HTTP/1.1 200 OK删除自定义图片黑库
谨慎使用 该接口会删除自定义图片黑库
- 注：删除图片黑库会导致绑定该库的审核模版不可用，删除图片黑库前请确认已无模版绑定该库。
请求语法
Plain Text
1DELETE /v<version>/image/lib/{name} HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| name | String | 库名称 | 是 |
请求示例
Plain Text
1DELETE /v1/image/lib/test HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>响应参数
无
响应示例
Plain Text
1HTTP/1.1 200 OK列出所有图片黑库
列出所有自定义图片黑库
请求语法
Plain Text
1GET /v<version>/image/lib HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>请求参数
无
请求示例
Plain Text
1GET /v1/image/lib HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| libs | Array | 自定义库集合 |
| +name | String | 库名称 |
| +description | String | 描述信息 |
| +count | Integer | 库内图片个数 |
| +createTime | Date | 创建时间 |
响应示例
Plain Text
1HTTP/1.1 200 OK
2{
3 "libs": [
4 {
5 "name": "test",
6 "count": 10,
7 "description": "desc",
8 "createTime": "2020-12-04T07:23:59Z"
9 }
10 ]
11}添加图片到黑库
往指定的自定义黑库中添加图片。
请求语法
Plain Text
1PUT /v<version>/image/lib/{name}?add HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>
5content-type: application/json请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| name | String | 库名称 | 是 |
| items | Array | 图片地址集合，最多100张 | 是 |
请求示例
Plain Text
1PUT /v1/image/lib/test?add HTTP/1.1
2host: vcr.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>
5x-bce-date: <bce-authorization-utc-date>
6
7{
8 "items": [
9 "http://image1.jpg",
10 "http://image2.jpg"
11 ]
12}响应参数
无
响应示例
Plain Text
1HTTP/1.1 200 OK从黑库中删除图片
删除指定的自定义黑库中的图片。
请求语法
Plain Text
1PUT /v<version>/image/lib/{name}?delete HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>
5content-type: application/json请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| name | String | 库名称 | 是 |
| items | Array | 图片ID集合，最多100张 | 是 |
请求示例
Plain Text
1PUT /v1/image/lib/test?delete HTTP/1.1
2host: vcr.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>
5x-bce-date: <bce-authorization-utc-date>
6
7{
8 "items": [
9 "X2bzk3YBeesIwZTbdF8Y",
10 "1wx7LHYBeesIwZTb_59J"
11 ]
12}响应参数
无
响应示例
Plain Text
1HTTP/1.1 200 OK查看黑库中的图片
查看自定义黑库中的图片列表
请求语法
Plain Text
1GET /v<version>/image/lib/{name}?pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| name | String | 库名称 | 是 |
| pageNo | Integer | 分页页数，默认为1 | 否 |
| pageSize | Integer | 分页显示条数，默认为20 | 否 |
请求示例
Plain Text
1GET /v1/image/lib/test?pageNo=1&pageSize=20 HTTP/1.1
2host: vcr.bj.baidubce.com
3authorization: <bce-authorization-string>
4x-bce-date: <bce-authorization-utc-date>响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| pageNo | Integer | 分页页数 |
| pageSize | Integer | 分页显示条数 |
| totalCount | Integer | 图片总数 |
| result | Array | 图片列表 |
| + id | String | 图片ID |
| + source | String | 图片地址 |
响应示例
Plain Text
1HTTP/1.1 200 OK
2{
3 "pageNo": 1,
4 "pageSize": 20,
5 "totalCount": 1,
6 "result": [
7 {
8 "id": "X2bzk3YBeesIwZTbdF8Y",
9 "source": "https://bj.bcebos.com/test.jpg"
10 }
11 ]
12}