网页检测任务提交
更新时间:
请求规范
- 请求 URL:
https://msafe.ilivedata.com/api/v1/media/web/submit
- 接口描述:
该接口用于提交网页媒体异步检测任务。你可以提交网页 URL，由服务抓取网页内容进行检测；也可以直接提交 HTML 源码进行检测。提交成功后，接口返回 taskId，检测结果会通过回调方式返回，也可以使用结果查询接口根据 taskId 查询。
- HTTP 请求 Header:
Header
示例值
是否必需
描述
Content-Type
application/json;charset=UTF-8
必需
请求体格式。该接口只接收 JSON 请求体
Accept
application/json;charset=UTF-8
可选
期望的响应格式。不传时默认返回 JSON
X-AppId
82100001
必需
项目的唯一标识，可在 <控制台-服务配置> 中获取
X-TimeStamp
2026-01-31T07:59:03Z
必需
请求发起时的 UTC 时间，格式为 yyyy-MM-dd'T'HH:mm:ss'Z'，例如：2026-01-31T23:59:59Z
Authorization
*****
必需
请求签名。签名计算规则请参考帮助中心的请求签名
- 请求方法:
POST
- 请求体 JSON:
参数
是否必需
类型
描述
url
条件必需
String
需要检测的网页 URL，必须以 http:// 或 https:// 开头。url 和 html 至少传一个
html
条件必需
String
需要检测的网页 HTML 源码。url 和 html 至少传一个；传入该字段时，服务直接解析该 HTML 内容，不再抓取 url
baseUrl
可选
String
HTML 源码中相对资源地址的解析基准 URL，必须以 http:// 或 https:// 开头。仅提交 html 时建议传入；不传时优先使用 url 作为基准地址
strategyId
必需
String
策略编号，通过控制台配置
callbackUrl
可选
String
接收检测结果的回调地址。传入该字段时，优先使用请求中的回调地址，而不是控制台配置的回调地址
- 通过 URL 提交请求体示例:
{
"url": "https://example.com/page.html",
"strategyId": "DEFAULT",
"callbackUrl": "https://example.com/callback"
}
- 直接提交 HTML 源码请求体示例:
{
"html": "<!doctype html><html><head><title>Test page</title></head><body><p>Text to moderate</p><img src=\"images/a.jpg\" alt=\"image text\"></body></html>",
"baseUrl": "https://example.com/page.html",
"strategyId": "DEFAULT",
"callbackUrl": "https://example.com/callback"
}
请求签名
该接口需要在请求 Header 中传入 Authorization 签名。签名计算规则请参考帮助中心的请求签名。
HTTP 响应
Content-Type: application/json;charset=UTF-8
结果为 JSON 格式，请参考以下示例。
- 返回 JSON 字段说明：
字段名
类型
描述
errorCode
Number
错误码，0 表示成功
errorMessage
String
错误消息
taskId
String
区分不同次调用的唯一标识
code
Number
任务状态码，2 表示任务检测中
- 响应示例:
{
"errorCode": 0,
"taskId": "task_**************************",
"code": 2
}
错误码
Http 状态码
错误码
错误消息
错误原因
200
0
此字段省略
请求成功
400
1003
Bad Request
请求体不是合法 JSON，或服务处理请求失败
400
1112
The project is closed now, please contact us to restart the project.
项目已关闭
400
2000
Missing Parameter
缺少必需参数，例如 strategyId，或 url 和 html 均为空
400
2001
Invalid Parameter
参数格式错误，例如 url 或 baseUrl 不是 HTTP/HTTPS 地址，或 strategyId 不存在
401
1102
Unauthorized Client
X-AppId 无效
401
1106
Missing Access Token
缺少 Authorization
401
1107
Invalid Token
Authorization 签名不正确
401
1108
Expired Token
X-TimeStamp 已过期
401
1110
Invalid Client
缺少 X-AppId
401
2000
Missing Parameter
缺少 X-TimeStamp
401
2001
Invalid Parameter
X-TimeStamp 格式错误
429
-
-
请求频率超过限制
请求规范
- 请求 URL:
https://msafe.ilivedata.com/api/v1/media/web/submit
- 接口描述:
该接口用于提交网页媒体异步检测任务。你可以提交网页 URL，由服务抓取网页内容进行检测；也可以直接提交 HTML 源码进行检测。提交成功后，接口返回 taskId，检测结果会通过回调方式返回，也可以使用结果查询接口根据 taskId 查询。
- HTTP 请求 Header:
| Header | 示例值 | 是否必需 | 描述 |
|---|---|---|---|
| Content-Type | application/json;charset=UTF-8 | 必需 | 请求体格式。该接口只接收 JSON 请求体 |
| Accept | application/json;charset=UTF-8 | 可选 | 期望的响应格式。不传时默认返回 JSON |
| X-AppId | 82100001 | 必需 | 项目的唯一标识，可在 <控制台-服务配置> 中获取 |
| X-TimeStamp | 2026-01-31T07:59:03Z | 必需 | 请求发起时的 UTC 时间，格式为 yyyy-MM-dd'T'HH:mm:ss'Z'，例如：2026-01-31T23:59:59Z |
| Authorization | ***** | 必需 | 请求签名。签名计算规则请参考帮助中心的请求签名 |
- 请求方法:
POST
- 请求体 JSON:
| 参数 | 是否必需 | 类型 | 描述 |
|---|---|---|---|
| url | 条件必需 | String | 需要检测的网页 URL，必须以 http:// 或 https:// 开头。url 和 html 至少传一个 |
| html | 条件必需 | String | 需要检测的网页 HTML 源码。url 和 html 至少传一个；传入该字段时，服务直接解析该 HTML 内容，不再抓取 url |
| baseUrl | 可选 | String | HTML 源码中相对资源地址的解析基准 URL，必须以 http:// 或 https:// 开头。仅提交 html 时建议传入；不传时优先使用 url 作为基准地址 |
| strategyId | 必需 | String | 策略编号，通过控制台配置 |
| callbackUrl | 可选 | String | 接收检测结果的回调地址。传入该字段时，优先使用请求中的回调地址，而不是控制台配置的回调地址 |
- 通过 URL 提交请求体示例:
{
"url": "https://example.com/page.html",
"strategyId": "DEFAULT",
"callbackUrl": "https://example.com/callback"
}
- 直接提交 HTML 源码请求体示例:
{
"html": "<!doctype html><html><head><title>Test page</title></head><body><p>Text to moderate</p><img src=\"images/a.jpg\" alt=\"image text\"></body></html>",
"baseUrl": "https://example.com/page.html",
"strategyId": "DEFAULT",
"callbackUrl": "https://example.com/callback"
}
请求签名
该接口需要在请求 Header 中传入 Authorization 签名。签名计算规则请参考帮助中心的请求签名。
HTTP 响应
Content-Type: application/json;charset=UTF-8
结果为 JSON 格式，请参考以下示例。
- 返回 JSON 字段说明：
| 字段名 | 类型 | 描述 |
|---|---|---|
| errorCode | Number | 错误码，0 表示成功 |
| errorMessage | String | 错误消息 |
| taskId | String | 区分不同次调用的唯一标识 |
| code | Number | 任务状态码，2 表示任务检测中 |
- 响应示例:
{
"errorCode": 0,
"taskId": "task_**************************",
"code": 2
}
错误码
| Http 状态码 | 错误码 | 错误消息 | 错误原因 |
|---|---|---|---|
| 200 | 0 | 此字段省略 | 请求成功 |
| 400 | 1003 | Bad Request | 请求体不是合法 JSON，或服务处理请求失败 |
| 400 | 1112 | The project is closed now, please contact us to restart the project. | 项目已关闭 |
| 400 | 2000 | Missing Parameter | 缺少必需参数，例如 strategyId，或 url 和 html 均为空 |
| 400 | 2001 | Invalid Parameter | 参数格式错误，例如 url 或 baseUrl 不是 HTTP/HTTPS 地址，或 strategyId 不存在 |
| 401 | 1102 | Unauthorized Client | X-AppId 无效 |
| 401 | 1106 | Missing Access Token | 缺少 Authorization |
| 401 | 1107 | Invalid Token | Authorization 签名不正确 |
| 401 | 1108 | Expired Token | X-TimeStamp 已过期 |
| 401 | 1110 | Invalid Client | 缺少 X-AppId |
| 401 | 2000 | Missing Parameter | 缺少 X-TimeStamp |
| 401 | 2001 | Invalid Parameter | X-TimeStamp 格式错误 |
| 429 | - | - | 请求频率超过限制 |