接口常见问题
实时返回机器审核结果的接口。
在线检测结果中不确定的数据,会进行离线分析和人工审核,这些数据的结果需要客户通过离线结果获取接口进行定时获取。
在线接口实时返回检测结果,帮助客户尽早拦截有害数据。为了进一步提高最终结果的准确性,易盾配备了专业编审团队,会对在线检测结果中不确定数据进行7*24小时审核。同时,在线检测每日会根据离线结果进行升级,提升在线检测效果。
易盾会对垃圾数据做出标记,客户可根据标记处理。例如文本在线检测返回不通过的,可以直接删除,返回疑似的,先设置为用户本人可见,等离线结果获取后再决定删除还是公开。
可以只调用在线检测接口,不可只调用离线结果获取接口。产品对内容质量要求高的,建议两个都调用。
非必选字段可以提升反垃圾效果,建议尽量提供。例如提供IP数据后,易盾就可对IP进行分析检测。
每个产品下文本默认200条/s,图片64张/s,视频直播100路/s,视频点播30路/s,直播电视墙100路/s,直播音频100路/s,点播音频30路/s,如有更大需求,请联系您的专属商务。
等待回调:数据状态有变更,等待客户调用离线接口获取。
不需要回调:在线返回通过和不通过的数据,数据状态没有变更。
已回调:数据状态有变更,客户已经通过离线接口获取。
按照不同业务划分,会单独创建业务,比如文本,图片,视频,音频,每个业务都会有独立的businessId。解决方案类业务是以产品维度创建,包括文档,融媒体,音视频解决方案,产品创建以后不需要单独创建业务,直接以产品维度进行调用,所以不需要使用businessId。
离线接口数据获取是一次性的,如果回调之后的数据想再次获取可以通过query接口,taskid值查询,获取查询接口demo地址。
主动推送需要在提交参数的时候提供回调地址callbackUrl,文本和图片在线检测之后,如果人工审核或质检之后可以触发回调,根据提交的回调地址推送人审或质检的结果。异步检测的业务,比如视频,音频,解决方案类产品,机审完成以后触发回调,人审根据回调配置也会触发回调。主动回调获取走结果,是不能再通过轮询接口进行获取。推送与轮询2种方式只能使用其中一种获取结果。
您服务端接收到我们推送的结果后,返回的HTTP状态码为200时,表示推送成功,其他的HTTP状态码均视为您接收失败,我们将每隔10分钟推送一次,如果一直失败,持续一天后不再推送;我们主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,客户需保证接收接口性能稳定并且保证幂等性。
(1)是否支持IPV6?
目前已经支持IPV6,ip字段目前不对长度做校验,可以直接传IPV6格式。
(2)接口请求参数dataid和图片接口请求参数name的作用
用户产品可以根据业务情况自行设计,该字段可以作为请求数据的唯一标识,方便定位和查询数据。
(3)callback字段
数据回调参数,调用方根据业务情况自行设计,作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,该字段在线提交,在离线接口返回时保持原数据返回。具体请参考各个离线接口文档说明。
(4)checkLabels字段
在对接前策略经理会与您约定过检的类型,进行业务配置,checkLabels字段默认不需要传参,如果您系统指定某个类别检测,可以传该参数指定检测,指定的类别需要在业务配置类别里进行指定,如果指定了未配置的类别,会按照参数错误返回。
(5)token字段
内容安全与反作弊融合版专属字段,来自易盾反作弊SDK返回的token,接入SDK必传,接入流程请参考防刷版说明文档。
(6)callbackUrl字段
callbackUrl回调地址,如果您使用推送方式获取异步检测结果,或人审结果,需要在提交时,传回调地址,在检测完成以后通过回调地址,推送检测结果。