第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
数据与智能专区
专区程序调用sdk
会话反垃圾分析
会话反垃圾分析
最后更新:2024/07/29

目录

  • 创建分析任务
  • 获取任务结果
  • 频率限制说明
  • 可调用本组接口对每条会话内容进行反垃圾分析。

    详细说明

    该接口仅支持分析文本消息
    应用类型权限要求
    自建应用需具备「数据与智能专区权限
    代开发应用需具备「数据与智能专区权限
    第三方应用需具备「数据与智能专区权限

     

    创建分析任务

    请求方法
    通过SDK调用,具体方式参考专区程序使用指引

    请求接口名:
    create_spam_task

     

    请求包体:

    {
        "msg_list":[
            {
                "msgid": "MSGID1",
                "encrypt_info":{
                    "secret_key": "SECRETKEY1"
                }
            },
            {
                "msgid": "MSGID2",
                "encrypt_info":{
                    "secret_key": "SECRETKEY2"
                }
            }
        ]
    }

    参数说明:

    参数是否必须说明
    msg_list消息列表,每次最多1000个。总和不超过1000个。
    msg_list.msgid每条消息对应的msgid。多次出现同一个msgid,以首次出现的为准
    msg_list.encrypt_info.secret_key该消息的密钥,将encrypted_secret_key用RSA私钥解密后得到

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok",
        "jobid": "JOBID",
        "fail_list":[
            {
                "errcode": 710601,
                "errmsg": "xxx",
                "msgid": "MSGID2",
                "encrypt_info":{
                    "secret_key": "SECRETKEY2"
                }
            }
        ]
    }

    参数说明:

    参数说明
    errcode错误码
    errmsg错误码说明
    jobid任务id。首次提交时返回
    fail_list提交出错的消息列表,只有msgid重复项返回至该列表
    fail_list.errcode错误码
    fail_list.errmsg错误码说明
    fail_list.msgid每条消息对应的msgid,与入参对应
    fail_list.msgid.encrypt_info每条消息对应的加密信息,与入参对应

    获取任务结果

    请求方法
    通过SDK调用,具体方式参考专区程序使用指引

    请求接口名:
    get_spam_result

    请求包体:

    {
        "jobid": "JOBID"
    }

    参数说明:

    参数是否必须说明
    jobid任务id

     

    返回结果:

    {
        "errcode": 0,
        "errmsg": "ok",
        "status": 1,
        "analyze_result_list":[
            {
                "errcode": 0,
                "errmsg": "ok",
                "msgid": "MSGID1",
                "spam_result": 1
            },
            {
                "errcode": 710601,
                "errmsg": "xxx",
                "msgid": "MSGID4"
            }
        ]
    }

    参数说明:

    参数说明
    errcode错误码
    errmsg错误码说明
    status任务执行状态
    0: 执行未完成
    1: 执行完成
    2: 执行失败
    analyze_result_list消息分析结果列表。详见ItemResult

    ItemResult说明

    参数说明
    msgid消息对应的msgid
    spam_result反垃圾分析结果
    0: 无违规
    1: 政治敏感
    2: 色情
    注:
    analyze_result_list 列表每次都会将所有会话消息返回,如果有会话消息的分析结果已经获得,则会将其填入结果中,还未获得的则不填。

    频率限制说明

    • 每企业每天反垃圾分析的消息条数不超过10万条(按消息条数限制,若每次提交分析的消息有1000条,则每天只能提交100次任务。)
    上一篇自有模型分析
    下一篇会话内容导出
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    小程序接入对外收款
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们