Help Center

融媒体解决方案提交接口

2022.07.06 13:48:09

接口地址

https://as.dun.163.com/v1/mediasolution/submit

接口描述

融媒体解决方案适用于，多种类型媒体（文本、图片、点播视频、点播音频、点播音视频、文档）合并过检场景，提交接口用于做数据提交。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

请求参数

公共参数已省略，详细见请求公共参数，请求版本号如下：

参数名称	类型	是否必选	最大长度	描述
version	String	Y	4	版本号，目前版本号为 v1.1

私有参数如下

参数名称	类型	是否必选	最大长度	描述
ip	String	N	128	用户IP地址
account	String	N	128	用户唯一标识，如果无需登录则为空
deviceId	String	N	128	用户设备 id，与易盾设备画像库匹配，明文请转大写传入；MD5加密请明文转大写后MD5计算，再转大写传入，建议抄送
deviceType	Number	N	4	用户设备id的类型，0:其他，10:IMEI，11:AndroidID，12:IDFA，13:IDFV，14:MAC ，20:IMEI_MD5，21:AndroidID_MD5，22:IDFA_MD5，23:IDFV_MD5，24:MAC_MD5
publishTime	Number	N	13	发表时间，UNIX 时间戳(毫秒值)
dataId	String	N	128	数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
title	String	N	512	融媒体标题
content	String(json数组)	Y	150000	json格式融媒体数据，详见下方content数据结构描述。支持多种类型内容同时过检，包括文本，图片，点播语音，点播视频，点播语音&点播视频，文档
自定义解析检测字段/解析不检测字段	String(json数组），同content	N	150000	业务自定义解析检测字段，确定字段名称、检测配置要求后，请与易盾策略经理沟通配置。同时支持自定义多个检测字段，详见下方content数据结构描述。支持多种类型内容同时过检，包括文本，图片，点播语音，点播视频，点播语音&点播视频，文档。注意：只要字段内容需要解析并展示在审核区域，就需要按此字段格式接入。
自定义非解析检测字段	String	N	1024	业务自定义非解析检测字段，非解析检测字段无法切换为检测字段，确认字段名称、非检测配置后请与易盾策略经理沟通配置。同时支持自定义多个字段，字段内容将展示在扩展信息区域，辅助人工审核。
callback	String	N	512	数据回调参数，调用方根据业务情况自行设计，当调用融媒体离线接口获取结果时，该接口会原样返回该字段。作为数据处理标识，因此该字段应该设计为能唯一定位到该次请求的数据结构，如对用户的昵称进行检测，dataId可设为用户标识（用户ID），用户修改多次，每次请求数据的dataId可能一致，但是callback参数可以设计成定位该次请求的数据结构，比如callback字段设计成json，包含dataId和请求的时间戳等信息，当然如果不想做区分，也可以直接把callback设置成dataId的值。
callbackUrl	String	N	1024	离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。
token	String	N	256	融媒体支持将部分数据同步到反作弊并检测结果，此字段为反作弊SDK获取的token，接入流程可见防刷版接入流程

content 数据结构

参数名称	类型	是否必选	最大长度	描述
type	String	Y	10	类型，分别为text-文本，image-图片，audio-点播语音，video-点播视频，audiovideo-点播语音&点播视频，file-文档
data	String	Y	5000	检测数据，类型为text时最多传入20条文本内容，每条最长5000字符；类型为image时最多传入50张图片url，每张最长512字符；类型为audio时最多传入5条语音url，每条最长512字符；类型为video时最多传入5条视频url，每条最长512字符；类型为audiovideo时最多传入5条音视频url，每条最长512字符；类型为file时最多传入10个文档url，每个最长512字符
dataId	String	N	128	数据唯一标识

响应结果

响应字段如下，响应通用字段已省略，详细见响应通用字段：

result 数据结构

参数名称	类型	描述
taskId	String	本次请求数据标识，可以根据该标识查询数据最新结果
dataId	String	数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
result	JSON对象	如果开启了文本和图片在线返回可以支持在线返回结果，其他业务是异步检测的，检测结果需要在离线接口获取。在线返回的文本和图片结构和"离线结果获取"接口中的"result 数据结构"一样。默认情况或未配置的情况下，检测结果异步回调返回。

响应示例

默认返回结构

{
    "code":200,
    "msg":"ok",
    "result":{
	     "antispam":{
                   "taskId":"91096d5f987f4d7ebeb9ed6b323c640c",
                   "dataId":"1997602",
                   "callback":"1608795172"
                }
	}
}

开启文本和图片在线返回

{
    "code":200,
    "msg":"ok",
    "result":{
      "antispam":{
                "taskId":"47cd56309c1247108ce190ad043ea99f",
                "dataId":"4581941",
                "callback":"1608794932",
                "evidences":{
                "texts":[
                   {
                    "action":0,
                    "dataId":"972897",
                    "labels":[

                    ],
                    "field":"other"
                   },
                  {
                    "action":0,
                    "dataId":"972197",
                    "labels":[

                    ],
                    "field":"other"
                   },
                   {
                    "action":0,
                    "dataId":"9744897",
                    "labels":[

                    ],
                    "field":"other"
                    }
                  ],
                "images":[
                   {
                    "name":"47cd56309c1247108ce190ad043ea99f",
                    "dataId":"975557",
                    "status":0,
                    "action":0,
                    "labels":[
                        {
                            "label":500,
                            "level":0,
                            "rate":0.96637547
                        },
                        {
                            "label":300,
                            "level":0,
                            "rate":1
                        },
                        {
                            "label":100,
                            "level":0,
                            "rate":0.99989283
                        },
                        {
                            "label":400,
                            "level":0,
                            "rate":1
                        },
                        {
                            "label":110,
                            "level":0,
                            "rate":0.9997302
                        },
                        {
                            "label":200,
                            "level":0,
                            "rate":1
                        },
                        {
                            "label":210,
                            "level":0,
                            "rate":1
                        },
                        {
                            "label":900,
                            "level":0,
                            "rate":1
                        }
                    ],
                    "field":"other"
                  }
            ],
            "audios":[

            ],
            "videos":[

            ],
            "audiovideos":[

            ],
            "files":[

              ]
           }
        }
    }
}

Comment On The Document:

If you encounter product-related problems, you can Submit a ticket 或 Online Chat Seek help.

Online Chat Tel：95163223 Free trial