接口常见问题

2024.05.27 11:05:48

    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)callback字段

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

    (2)scFrequency字段

    认截帧设置,默认5秒截图检测一次,可设置范围为0.5~600秒。

    (3)advancedFrequency字段

    高级截帧设置,此项填写,默认截帧策略失效,durationPoints设置的是视频时长间隔,frequencies是截图频率,示例如{"durationPoints":[300,600],"frequencies":[1,5,10]},视频按照0-300s,300-600s,600s以上,在这3个区间内截图频率为1s,5s,10s。

    (4)uniqueKey字段

    检测去重字段,填入后使用此字段去重,默认以url判断提交是否重复。

    (5)callbackUrl

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

    14.视频业务常见问题

    (1)视频处理状态码有哪些?

    0:检测成功。

    110:请求重复,视频检测以业务id和url为依据,如果当前业务下有一个正在检测的视频,此时提交相同的url,会判定为重复提交,接口返回110请求重复。

    120:参数错误,请求的url不合法,或者其他请求参数错误,请您核查。

    130:解析错误,视频无法正常解析。

    140:数据类型错误,视频格式异常。

    160:视频大小超限(>5G)

    如有以上问题请您及时联系我们。

    (2)点播视频是否支持同步检测?

    目前点播视频都是异步检测,因为视频数据涉及到下载之后再截图处理,所以目前都是异步检测,检测完成以后返回检测结果。

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

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

    {
        "code":417,
        "msg":"返回原提交taskID值"
    }
    
    Online Chat Tel:95163223 Free trial