You need to enable JavaScript to run this app.
导航

ArticleEventNotify-质检任务变更同步

最近更新时间2024.03.01 10:48:26

首次发布时间2023.11.10 14:14:18

内容在成功导入到内容管理平台后,会被执行异步质检任务。客户侧若需要获取质检任务的变更事件需要调用本接口。

注意事项

  • 使用限制:
    • 接口查询范围: 无穷回溯影响性能,因此接口仅支持7日内的数据查询;
  • 请求频率:
    • 接口请求时间:间隔至少需超过 2s

请求说明

  • 请求方式:POST
  • 请求地址:https://cms.volcengineapi.com?Action=ArticleEventNotify&Version=2021-01-01
  • 请求头:ServiceName: volc_content_platform

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数
类型
是否必填
示例值
描述
Action
String

ArticleEventNotify

要执行的操作,取值:ArticleEventNotify

Version
String

2021-01-01

API的版本,取值:2021-01-01

Body

参数
类型
是否必填
示例值
描述
GenerateType
String

toutiao_api

查询指定Api来源的内容的同步状态,不传则不进行筛选查询,取值路径:控制台 - 内容引入 - 内容源管理 - Api源标识。

EventType
String

AuditTaskChange

事件类型,固定值"AuditTaskChange"。

CursorTime
Long

1638283523

时间锚。

说明

CursorTime使用方式:

  • 首次请求传 0,根据时间排序,返回前100条有关的数据;
  • 返回结果包含下次请求的 CursorTime 值,循环上述操作;
  • 当返回结果数据量不足100条时,说明已没有更多数据。

注意

  • CursorTime的初次请求传0或其他值,也会计算为一次请求,下一次请间隔至少2s再请求。
SubEventTypeList
Array of String

子事件类型列表。
枚举值:

SubEventType描述
AuditTaskApprove通过
AuditTaskReject不通过

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
Result
ArticleEventNotifyResult

请求结果。

EventDetail

EventDetail类型为字符串,由以下结构JsonEncode得到。

{
    "AuthorStrategyHit":null, //null:未命中黑白名单 WhiteList:命中白名单  BlackList:命中黑名单
    "GenerateType":"chenke_machine_manual",
    "GroupId":"1774377316655104",
    "GroupOpenId":"",
    "TaskInfo":{
        "MachineAuditResult":"Abnormal", //机器质检结果 None:无机器质检流程 Abnormal: 异常 Normal: 正常
        "ModelInfoList":[
            {
                "Category":[
                    "敏感词"
                ],
                "ID":"0",
                "Modular":"文本质检模型",
                "Name":"敏感词匹配",
                "Prob":1.1, // 命中阈值
                "Result":"Suspected" // 判定结果:Suspected:疑似 Danger:高危
            },
            {
                "Category":[
                    "涉敏"
                ],
                "HitInfo":[
                    "阈值处于配置范围"
                ],
                "ID":"3",
                "Modular":"文本质检模型",
                "Name":"短文本涉敏",
                "Prob":0.00004082918167114258,
                "Result":"Suspected"
            }
        ],
        "HitInfo": null,
        "ProcessType":"MachineAndManual", // 质检流程 OnlyMachine:仅机审 OnlyManual:仅人审 MachineAndManual:机审+人审
        "ProjectId":"1691662613490466816",
        "ProjectStrategyType":"Source", //队列类型 Model:模型 Source:来源 Collection:集合
        "ProjectTitle":"chenke_machine_manual-图文",//队列名称
        "TaskId":"1691781295705194496",
        "TaskResult":"Reject",//任务结果 Approve:通过 Reject:未通过
        "TaskRound":"ManualRound", // 任务轮次 MachineRound:机审  ManualRound:人审 SamplingRound:抽检 ReviseRound:修正
        "TaskStatus":"Completed" // 任务状态 Waiting:待质检 Completed:已完成 WaitSampling:待抽检
    }
}

请求示例

{
    "CursorTime": 0,
    "EventType": "AuditTaskChange",
    "GenerateType": "zhihu"
}

返回示例

  • 返回成功
{
    "ResponseMetadata": {
        "RequestId": "2023081811443219216800006489***",
        "Action": "ArticleEventNotify",
        "Version": "2021-01-01",
        "Service": "volc_content_platform",
        "Region": "cn-north-1"
    },
    "Result": {
        "Items": [
            {
                "EventType": "AuditTaskChange",
                "SubEventType": "AuditTaskApprove",
                "EventTime": 1692274948,
                "ArticleId": 7268258221708607778,
                "GenerateType": "test_lang",
                "EventDetail": "\"{\\\"AuthorStrategyHit\\\":null,\\\"GenerateType\\\":\\\"test_lang\\\",\\\"GroupId\\\":\\\"7268258221708607778\\\",\\\"GroupOpenId\\\":\\\"\\\",\\\"TaskInfo\\\":{\\\"HitInfo\\\":[\\\"系统词表\\\"],\\\"MachineAuditResult\\\":\\\"Abnormal\\\",\\\"ModelInfoList\\\":[{\\\"Category\\\":[\\\"敏感词\\\"],\\\"ID\\\":\\\"0\\\",\\\"Modular\\\":\\\"文本质检模型\\\",\\\"Name\\\":\\\"敏感词匹配\\\",\\\"Prob\\\":1,\\\"Result\\\":\\\"Danger\\\"},{\\\"Category\\\":[\\\"低俗\\\"],\\\"ID\\\":\\\"1\\\",\\\"Modular\\\":\\\"文本质检模型\\\",\\\"Name\\\":\\\"短文本低俗\\\",\\\"Prob\\\":0.000038504600524902344,\\\"Result\\\":\\\"Suspected\\\"},{\\\"Category\\\":[\\\"谩骂\\\"],\\\"ID\\\":\\\"4\\\",\\\"Modular\\\":\\\"文本质检模型\\\",\\\"Name\\\":\\\"短文本谩骂\\\",\\\"Prob\\\":0.32080078125,\\\"Result\\\":\\\"Suspected\\\"}],\\\"ProcessType\\\":\\\"MachineAndManual\\\",\\\"ProjectId\\\":\\\"1692108899487776768\\\",\\\"ProjectStrategyType\\\":\\\"Model\\\",\\\"ProjectTitle\\\":\\\"模型送审\\\",\\\"TaskId\\\":\\\"1692149567129726976\\\",\\\"TaskResult\\\":\\\"Approve\\\",\\\"TaskRound\\\":\\\"ReviseRound\\\",\\\"TaskStatus\\\":\\\"Waiting\\\"}}\""
            },
            {
                "EventType": "AuditTaskChange",
                "SubEventType": "AuditTaskApprove",
                "EventTime": 1692326470,
                "ArticleId": 7265568111892414754,
                "GenerateType": "test_dong",
                "EventDetail": "\"{\\\"AuthorStrategyHit\\\":null,\\\"GenerateType\\\":\\\"test_dong\\\",\\\"GroupId\\\":\\\"7265568111892414754\\\",\\\"GroupOpenId\\\":\\\"\\\",\\\"TaskInfo\\\":{\\\"HitInfo\\\":[\\\"金融产品宣传敏感词识别\\\",\\\"测试词表\\\"],\\\"MachineAuditResult\\\":\\\"Abnormal\\\",\\\"ModelInfoList\\\":[{\\\"Category\\\":[\\\"敏感词\\\"],\\\"ID\\\":\\\"64\\\",\\\"Modular\\\":\\\"文本质检模型\\\",\\\"Name\\\":\\\"金融产品宣传敏感词识别\\\",\\\"Prob\\\":1,\\\"Result\\\":\\\"Danger\\\"},{\\\"Category\\\":[\\\"敏感词\\\"],\\\"ID\\\":\\\"0\\\",\\\"Modular\\\":\\\"文本质检模型\\\",\\\"Name\\\":\\\"敏感词匹配\\\",\\\"Prob\\\":1,\\\"Result\\\":\\\"Danger\\\"},{\\\"Category\\\":null,\\\"ID\\\":\\\"40\\\",\\\"Modular\\\":\\\"\\\",\\\"Name\\\":\\\"图片综合质量\\\",\\\"Prob\\\":3913.0000000000005,\\\"Result\\\":\\\"Normal\\\"},{\\\"Category\\\":[\\\"涉敏\\\"],\\\"ID\\\":\\\"204\\\",\\\"Modular\\\":\\\"图片质检模型\\\",\\\"Name\\\":\\\"图片文本涉敏\\\",\\\"Prob\\\":0.9150390625,\\\"Result\\\":\\\"Danger\\\"},{\\\"Category\\\":[\\\"违法违规\\\"],\\\"ID\\\":\\\"74\\\",\\\"Modular\\\":\\\"图片质检模型\\\",\\\"Name\\\":\\\"图片人群聚集(社会事件)\\\",\\\"Prob\\\":0.9040632843971252,\\\"Result\\\":\\\"Danger\\\"}],\\\"ProcessType\\\":\\\"MachineAndManual\\\",\\\"ProjectId\\\":\\\"1687076699474067456\\\",\\\"ProjectStrategyType\\\":\\\"Source\\\",\\\"ProjectTitle\\\":\\\"test_dong-图文\\\",\\\"TaskId\\\":\\\"1689525150318804992\\\",\\\"TaskResult\\\":\\\"Approve\\\",\\\"TaskRound\\\":\\\"ReviseRound\\\",\\\"TaskStatus\\\":\\\"Completed\\\"}}\""
            }
        ],
        "CursorTime": 1692326470
    }
}
  • 请求频率超过限制
{
    "ResponseMetadata": {
        "RequestId": "2021120115503701021120913100009***",
        "Action": "ArticleEventNotify",
        "Version": "2021-01-01",
        "Service": "volc_content_platform",
        "Region": "cn-north-1",
        "Error": {
            "CodeN": 100027,
            "Code": "AccountFlowLimitExceeded",
            "Message": "Request was rejected because the request speed of this openAPI is beyond the current flow control limit."
        }
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
200
600400
参数错误

内容为空,或者是入参的类型是否与文档中不一致

200
600500
服务未知错误

服务内部异常,请联系商务