接口常见问题

2024.10.25 13:40:26

    1.什么是在线检测接口?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    9.所有业务都使用同一个businessId吗?

    按照不同业务划分,会单独创建业务,比如文本,图片,视频,音频,每个业务都会有独立的businessId。解决方案类业务是以产品维度创建,包括文档,融媒体,音视频解决方案,产品创建以后不需要单独创建业务,直接以产品维度进行调用,所以不需要使用businessId。

    10.轮询回调是否可以调用多次?

    离线接口数据获取是一次性的,如果回调之后的数据想再次获取可以通过query接口,taskid值查询,获取查询接口demo地址

    11.推送与轮询回调的区别?

    主动推送需要在提交参数的时候提供回调地址callbackUrl,文本和图片在线检测之后,如果人工审核或质检之后可以触发回调,根据提交的回调地址推送人审或质检的结果。异步检测的业务,比如视频,音频,解决方案类产品,机审完成以后触发回调,人审根据回调配置也会触发回调。主动回调获取走结果,是不能再通过轮询接口进行获取。推送与轮询2种方式只能使用其中一种获取结果。

    12.如果推送失败,如何获取检测结果?

    您服务端接收到我们推送的结果后,返回的HTTP状态码为200时,表示推送成功,其他的HTTP状态码均视为您接收失败,我们将每隔10分钟推送一次,如果一直失败,持续一天后不再推送;我们主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,客户需保证接收接口性能稳定并且保证幂等性。

    13.拓展字段含义

    (1)是否支持IPV6?

    目前已经支持IPV6,ip字段目前不对长度做校验,可以直接传IPV6格式。

    (2)接口请求参数dataid和图片接口请求参数name的作用

    用户产品可以根据业务情况自行设计,该字段可以作为请求数据的唯一标识,方便定位和查询数据。

    (3)callback字段

    数据回调参数,调用方根据业务情况自行设计,作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,该字段在线提交,在离线接口返回时保持原数据返回。具体请参考各个离线接口文档说明。

    (4)checkLabels字段

    在对接前策略经理会与您约定过检的类型,进行业务配置,checkLabels字段默认不需要传参,如果您系统指定某个类别检测,可以传该参数指定检测,指定的类别需要在业务配置类别里进行指定,如果指定了未配置的类别,会按照参数错误返回。

    (5)token字段

    内容安全与反作弊融合版专属字段,来自易盾反作弊SDK返回的token,接入SDK必传,接入流程请参考防刷版说明文档。

    (6)callbackUrl字段

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

    14.音视频业务常见问题

    (1)视频检测可以支持检测语音内容吗?

    目前音视频解决方案业务,支持同时检测视频和视频内语音内容,并且可以支持指定视频或音频检测。

    (2)接口提交返回响应码417

    以提交的url判断,如果当前有正在检测的url数据,重复提交则返回417响应码,以及正在检测的数据taskId。如果提交过相同的url,已经检测完成的数据,可以再次提交。

    {
        "code":417,
        "msg":"返回原提交taskID值"
    }
    

    (3)直播音视频是否支持多人场景检测?

    目前我们支持搭配声网、云信、即构,火山引擎RTC模式,进行实时内容检测,具体请查看直播音频接口调用概述

    Online Chat Tel:95163223 Free trial