图片黑白名单
更新时间:
接口概览
增加黑白名单图片，以控制图片审核结果。type=0 表示黑名单，type=1 表示白名单。
添加图片
POSThttps://isafe.ilivedata.com/api/v1/image/stats/black-white-list
通过 imageType 指定图片格式：1 为 URL，2 为 Base64（默认，兼容已有请求）。URL 须为公网 HTTP/HTTPS 直链，不支持跳转，单张下载大小不超过 10 MiB，连接和读取超时均为 10 秒。
请求参数
请求头
Header
值
描述
Content-Typeapplication/json;charset=UTF-8
请求体类型
Acceptapplication/json;charset=UTF-8
建议设置，指定响应格式
X-AppId—
图片项目编号；与审核请求一致；
X-TimeStamp—
当前 UTC 时间，例如 2026-10-19T02:30:00Z，实际请求使用当前时间
Authorization—
使用项目 API 密钥计算的签名
请求体
参数
类型
是否必需
描述
typeInteger
必需
0 黑名单；1 白名单
imageTypeInteger
可选
1：URL；2：Base64，默认 2，不可为 null；与黑白名单类型 type 无关
imagesArray<String>
必需
非空图片数组，同一次请求格式一致。imageType=1 时为图片 URL；imageType=2 时为 Base64 或 data:image/png;base64,...
tagsArray<Integer>
条件必需
黑名单（type=0）必填且非空；白名单可省略或传 null，提供数组时不得为空。每项必须是项目已发布的合法图片一级类别编号，不接受 null、非正数、二级类别或未知编号；例如 120 表示违禁
operatorString
可选
操作人，建议填写以便追踪
请求示例
URL 添加
{
"type": 0,
"imageType": 1,
"tags": [
120
],
"images": [
"https://example.com/image.png"
],
"operator": "api-user"
}
请替换为实际可访问的图片直链，服务端下载后存入图库。
Base64 添加
{
"type": 0,
"imageType": 2,
"tags": [
120
],
"images": [
"data:image/png;base64,<完整图片Base64>"
],
"operator": "api-user"
}
将占位内容替换为完整、可解码的图片。成功返回 code=0，当前接口不返回新增记录 ID。可在控制台对应项目的【黑白名单管理】中核对。新增没有去重保证，超时后应先在控制台确认是否已添加，避免重复提交。
请求签名
签名计算规则见帮助中心的请求签名。本接口使用项目 API 密钥，签名参数如下：
签名参数
值
HTTPMethodPOST
HostHeaderInLowercaseisafe.ilivedata.com
HTTPRequestURI/api/v1/image/stats/black-white-list
请求域名和签名 Host 均使用 isafe.ilivedata.com。本接口无需携带 URL 查询参数或设置 X-Nonce、X-RtmId 请求头。
HTTP 响应
Content-Type: application/json;charset=UTF-8
结果为 JSON 格式。
响应字段
参数
类型
描述
codeNumber
业务状态码，0 表示成功
msgString
响应消息，可为 null
datanull
添加成功时为 null，不返回新增记录 ID
响应示例
添加成功：
{
"code": 0,
"msg": null,
"data": null
}
错误码
同时检查 HTTP 状态码和业务 code；code=0 表示业务成功。网关鉴权失败可能返回 HTTP 401，例如 {"errorCode":1107,"errorMessage":"Invalid Token"}。此时检查项目密钥、实际域名、完整路径、时间戳和发送的 JSON 字节是否与签名一致。参数校验失败通常返回 HTTP 400。
添加前会校验类别配置；配置服务不可用时返回 HTTP 503，不执行图片上传或入库。
接口概览
增加黑白名单图片，以控制图片审核结果。type=0 表示黑名单，type=1 表示白名单。
添加图片
POST
https://isafe.ilivedata.com/api/v1/image/stats/black-white-list通过 imageType 指定图片格式：1 为 URL，2 为 Base64（默认，兼容已有请求）。URL 须为公网 HTTP/HTTPS 直链，不支持跳转，单张下载大小不超过 10 MiB，连接和读取超时均为 10 秒。
请求参数
请求头
| Header | 值 | 描述 |
|---|---|---|
Content-Type |
application/json;charset=UTF-8 | 请求体类型 |
Accept |
application/json;charset=UTF-8 | 建议设置，指定响应格式 |
X-AppId |
— | 图片项目编号；与审核请求一致； |
X-TimeStamp |
— | 当前 UTC 时间，例如 2026-10-19T02:30:00Z，实际请求使用当前时间 |
Authorization |
— | 使用项目 API 密钥计算的签名 |
请求体
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
type |
Integer | 必需 | 0 黑名单；1 白名单 |
imageType |
Integer | 可选 | 1：URL；2：Base64，默认 2，不可为 null；与黑白名单类型 type 无关 |
images |
Array<String> | 必需 | 非空图片数组，同一次请求格式一致。imageType=1 时为图片 URL；imageType=2 时为 Base64 或 data:image/png;base64,... |
tags |
Array<Integer> | 条件必需 | 黑名单（type=0）必填且非空；白名单可省略或传 null，提供数组时不得为空。每项必须是项目已发布的合法图片一级类别编号，不接受 null、非正数、二级类别或未知编号；例如 120 表示违禁 |
operator |
String | 可选 | 操作人，建议填写以便追踪 |
请求示例
URL 添加
{
"type": 0,
"imageType": 1,
"tags": [
120
],
"images": [
"https://example.com/image.png"
],
"operator": "api-user"
}
请替换为实际可访问的图片直链，服务端下载后存入图库。
Base64 添加
{
"type": 0,
"imageType": 2,
"tags": [
120
],
"images": [
"data:image/png;base64,<完整图片Base64>"
],
"operator": "api-user"
}
将占位内容替换为完整、可解码的图片。成功返回 code=0，当前接口不返回新增记录 ID。可在控制台对应项目的【黑白名单管理】中核对。新增没有去重保证，超时后应先在控制台确认是否已添加，避免重复提交。
请求签名
签名计算规则见帮助中心的请求签名。本接口使用项目 API 密钥，签名参数如下：
| 签名参数 | 值 |
|---|---|
HTTPMethod |
POST |
HostHeaderInLowercase |
isafe.ilivedata.com |
HTTPRequestURI |
/api/v1/image/stats/black-white-list |
请求域名和签名 Host 均使用 isafe.ilivedata.com。本接口无需携带 URL 查询参数或设置 X-Nonce、X-RtmId 请求头。
HTTP 响应
Content-Type: application/json;charset=UTF-8
结果为 JSON 格式。
响应字段
| 参数 | 类型 | 描述 |
|---|---|---|
code |
Number | 业务状态码，0 表示成功 |
msg |
String | 响应消息，可为 null |
data |
null | 添加成功时为 null，不返回新增记录 ID |
响应示例
添加成功：
{
"code": 0,
"msg": null,
"data": null
}
错误码
同时检查 HTTP 状态码和业务 code；code=0 表示业务成功。网关鉴权失败可能返回 HTTP 401，例如 {"errorCode":1107,"errorMessage":"Invalid Token"}。此时检查项目密钥、实际域名、完整路径、时间戳和发送的 JSON 字节是否与签名一致。参数校验失败通常返回 HTTP 400。
添加前会校验类别配置；配置服务不可用时返回 HTTP 503，不执行图片上传或入库。