开发者指南

API 文档

SDK 文档

查询视频审核内容

最近更新时间:2020-08-11 15:57:54

功能描述

DescribeAuditingJob 接口用来查询指定的视频审核任务。您可以根据视频审核任务的 job Id 来查询视频审核结果。

请求

请求示例

GET /video/auditing/<jobId> HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:

  • 此接口 Host 需要填写数据万象域名。
  • Authorization: Auth String(详情请参见 请求签名 文档)。

请求头

此接口仅使用数据万象的公共请求头部,详情请参见数据万象 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回数据万象的公共响应头部,详情请参见数据万象 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:

<Response>
  <JobsDetail>
    <Code>Success</Code>
    <Message>Success</Message>
    <JobId></JobId>
    <State></State>
    <CreationTime></CreationTime>
    <Object></Object>
    <SnapshotCount></SnapshotCount>
    <Result>1</Result>
    <PornInfo>
        <HitFlag></HitFlag>
        <Count></Count>
    </PornInfo>
    <TerrorismInfo>
        <HitFlag></HitFlag>
        <Count></Count>
    </TerrorismInfo>
    <PoliticsInfo>
        <HitFlag></HitFlag>
        <Count></Count>
    </PoliticsInfo>
    <AdsInfo>
        <HitFlag></HitFlag>
        <Count></Count>
    </AdsInfo>
    <Snapshot>
        <Url></Url>
        <PornInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </PornInfo>
        <TerrorismInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </TerrorismInfo>
        <PoliticsInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </PoliticsInfo>
        <AdsInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </AdsInfo>
    </Snapshot>
    <Snapshot>
        <Url></Url>
        <PornInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </PornInfo>
        <TerrorismInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </TerrorismInfo>
        <PoliticsInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </PoliticsInfo>
        <AdsInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </AdsInfo>
    </Snapshot>
  </JobsDetail>
  <NonExistJobIds></NonExistJobIds>
</Response>

具体的数据内容如下:

节点名称(关键字) 父节点 描述 类型
Response 保存结果的容器 Container

Container 节点 Response 的内容:

节点名称(关键字) 父节点 描述 类型
JobsDetail Response 任务的详细信息 Container
NonExistJobIds Response 查询的 ID 中不存在任务,所有任务都存在时不返回 String

Container 节点 JobsDetail 的内容:

节点名称(关键字) 父节点 描述 类型
Code Response.JobsDetail 错误码,只有 State 为 Failed 时有意义 String
Message Response.JobsDetail 错误描述,只有 State 为 Failed 时有意义 String
JobId Response.JobsDetail 任务的 ID String
State Response.JobsDetail 任务的状态,值为 Submitted、Snapshoting、Success、Failed、Auditing 其中一个 String
CreationTime Response.JobsDetail 任务的创建时间 String
Object Response.JobsDetail 视频对象 String
SnapshotCount Response.JobsDetail 截图数量 String
result Response.JobsDetail 供参考的识别结果,0表示确认正常,1表示确认敏感,2表示疑似敏感 String
PornInfo Response.JobsDetail 涉黄信息,审核信息 Container
TerrorismInfo Response.JobsDetail 涉暴恐信息,审核信息 Container
PoliticsInfo Response.JobsDetail 涉政信息,审核信息 Container
AdsInfo Response.JobsDetail 广告引导信息,审核信息 Container
Snapshot Response.JobsDetail 截图信息,只返回违规截图信息 Container

Container 节点 PornInfo,TerrorismInfo,PoliticsInfo,AdsInfo 的内容:

节点名称(关键字) 父节点 描述 类型
HitFlag Response.JobsDetail.*Info 是否命中该审核分类 String
Count Response.JobsDetail.*Info 命中该审核分类的截图张数 String

Container 节点 Snapshot 的内容:

节点名称(关键字) 父节点 描述 类型
Url Response.JobsDetail.Snapshot 视频截图地址 String
PornInfo Response.JobsDetail.Snapshot 涉黄信息,视频截图审核信息 Container
TerrorismInfo Response.JobsDetail.Snapshot 涉暴恐信息,视频截图审核信息 Container
PoliticsInfo Response.JobsDetail.Snapshot 涉政信息,视频截图审核信息 Container
AdsInfo Response.JobsDetail.Snapshot 广告引导信息,视频截图审核信息 Container

Container 节点 PornInfo,TerrorismInfo,PoliticsInfo,AdsInfo 的内容:

节点名称(关键字) 父节点 描述 类型
Code Response.JobsDetail.Snapshot.*Info 错误码,0为正确,其他数字对应相应错误 String
HitFlag Response.JobsDetail.Snapshot.*Info 是否命中该审核分类 String
Score Response.JobsDetail.Snapshot.*Info 截图审核分数 String
Label Response.JobsDetail.Snapshot.*Info 图片标签 String

错误码

此接口遵循统一的错误响应和错误码,详情请参见数据万象 错误码 文档。

实际案例

请求

GET /auditing/vab1ca9fc8a3ed11ea834c525400863904 HTTP/1.1
Accept: */*
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 666
Connection: keep-alive
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
  <JobsDetail>
    <Code>Success</Code>
    <Message>Success</Message>
    <JobId>vab1ca9fc8a3ed11ea834c525400863904</JobId>
    <State>Success</State>
    <CreationTime>2019-07-07T12:12:12+0800</CreationTime>
    <Object>a.mp4</Object>
    <SnapshotCount>100</SnapshotCount>
    <Result>1</Result>
    <PornInfo>
        <HitFlag>1</HitFlag>
        <Count>3</Count>
    </PornInfo>
    <TerrorismInfo>
        <HitFlag>0</HitFlag>
        <Count>0</Count>
    </TerrorismInfo>
    <PoliticsInfo>
        <HitFlag>0</HitFlag>
        <Count>0</Count>
    </PoliticsInfo>
    <AdsInfo>
        <HitFlag>1</HitFlag>
        <Count>1</Count>
    </AdsInfo>
    <Snapshot>
        <Url></Url>
        <PornInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </PornInfo>
        <TerrorismInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </TerrorismInfo>
        <PoliticsInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </PoliticsInfo>
        <AdsInfo>
            <Code></Code>
            <HitFlag></HitFlag>
            <Score></Score>
            <Label></Label>
        </AdsInfo>
    </Snapshot>
  </JobsDetail>
</Response>
目录