接口常见问题

2022.06.27 15:10:34
    • 什么是在线检测接口?

    实时返回机器审核结果的接口。

    • 什么是离线结果获取接口?

    在线检测结果中不确定的数据,会进行离线分析和人工审核,这些数据的结果需要客户通过离线结果获取接口进行定时获取

    • 易盾为什么要设计在线检测和离线结果获取两种接口?

    在线接口实时返回检测结果,帮助客户尽早拦截有害数据。为了进一步提高最终结果的准确性,易盾配备了专业编审团队,会对在线检测结果中不确定数据进行7*24小时审核。同时,在线检测每日会根据离线结果进行升级,提升在线检测效果。

    • 通过易盾接口获取到的结果,客户怎么处理?

    易盾会对垃圾数据做出标记,客户可根据标记处理。例如文本在线检测返回不通过的,可以直接删除,返回疑似的,先设置为用户本人可见,等离线结果获取后再决定删除还是公开。

    • 在线检测接口和离线结果获取接口可否只调用其中一个?

    可以只调在线检测接口,不可只调离线结果获取接口。产品对内容质量要求高的,建议两个都调用。

    • 接口参数里的非必选字段有什么用?

    非必选字段可以提升反垃圾效果,建议尽量提供。例如提供IP数据后,易盾就可对IP进行分析检测。

    • 易盾在线检测接口支持最大QPS是多少?

    每个产品下文本默认200条/s,图片64张/s,视频直播100路/s,视频点播30路/s,直播电视墙100路/s,直播音频100路/s,点播音频30路/s,如有更大需求,请联系您的专属商务。

    • 易盾用户中心文本数据查询页面中的等待回调、不需要回调、已回调三种回调状态分别是什么意思?

    等待回调:数据状态有变更,等待客户调用离线接口获取

    不需要回调:在线返回通过和不通过的数据,数据状态没有变更

    已回调:数据状态有变更,客户已经通过离线接口获取

    • 所有业务都使用同一个buinessId么?

    按照不同业务划分,会单独创建业务,比如文本,图片,视频,音频,每个业务都会有独立的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.callabckUrl字段

    callbackUrl 回调地址,如果您使用推送方式获取异步检测结果,或人审结果,需要在提交时,传回调地址,在检测完成以后通过回调地址,推送检测结果。

    • 图片业务常见问题

    1.图片检测失败的情况包含哪几种?

    610:图片下载失败,图片的连接访问不存在或者无访问权限导致的下载失败。

    620:图片格式错误,图片格式识别不是取决于url中的名称后缀,是图片本身的格式存在异常,或者是图片上传图床不完整导致下载时无法识别图片格式导致。

    630:其他下载失败情况预留,或者是图片预处理失败的情况,请您联系我们。

    建议图片检测结果先判断检测状态status,检测失败默认按照通过返回,不具有检测参考意义

    2.图片检测大小建议?

    一般建议的图片大小不超过10M,大于50px* 50px;

    如像素过低,图像质量较差对于检测效果会有影响,建议尺寸:1024px* 1024px;

    3.接口调用返回405参数错误

    请检查images请求格式:imgaes=[{name:1.jpg,type:1,data:http://xxx.com/xxx.j1pg},{name:2.jpg,type:1,data:http://xxx.com/xxx.2jpg}] 确认图片地址协议,会校验是否为https或http协议,如果图片格式校验错误也会返回参数错误。

    Online Chat Tel:95163223