跳到主要内容

视频调用记录

1. 请求

1.1 请求地址

区域请求地址
国内https://api.open.tuputech.com/v3/management/history/video/<secretId>
提示

<secretId> 需替换为您的应用 SID,请联系客户经理为您开通及配置。关于 SID 详见 常见问题(FAQ)

1.2 请求方法

POST

1.3 请求头

Content-Type: application/json

1.4 请求参数

参数名称类型是否必需说明
timestampInt当前服务器的 Unix 时间戳,可以是毫秒或秒级
nonceFloat随机数(建议使用 Unix 时间戳或若干位随机整数)
signatureString

RSA-SHA256 算法签名。签名步骤:

  1. 将参与签名的参数(secretIdtimestampnonce)用英文半角逗号 , 拼接,得到 SignString
  2. 使用您的私钥以 RSA-SHA256 算法对 SignString 签名,然后进行 Base64 编码,得到 signature 字符串。
  • 点击 数字证书 下载私钥。私钥有 rsapkcs8 两种格式,通常 Golang,Python 使用 rsa 格式私钥,Java 使用 pkcs8 格式私钥
  • 点击 签名及验证示例 查看签名示例
startTimeString时间范围,起始时间 (时间格式 yyyy-MM-dd hh:mm:ss)
endTimestring时间范围,结束时间 (时间格式 yyyy-MM-dd hh:mm:ss)
pageInt分页参数,查询页码
limitInt分页参数,每页大小
sortInt排序,-1:倒序,1:顺序
sortByString排序字段
originalFileString源文件链接

1.5 请求示例

{
"timestamp": "<timestamp>",
"nonce": "<nonce>",
"signature": "<signature>",
"startTime": "2022-12-02 00:00:00",
"endTime": "2022-12-08 00:00:00",
"page": 20,
"limit": 1,
"originalFile":"testFilePath",
"sort": -1,
"sortBy": "createTime",
}

2. 响应

2.1 响应内容

参数名称类型说明
jsonString响应内容 JSON 转义后的字符串
signatureString响应内容签名

2.2 响应参数

参数名称类型是否可能为空说明
hasNextBoolean是否存在下一页
totalInt调用记录总数
dataArray<videoHistory>调用总览信息,详见 videoHistory 参数说明

videoHistory 参数说明

参数名称类型是否可能为空说明
idString视频 ID(可用于查询视频下图片识别任务的字段查询)
secretIdString应用 ID
filePathString文件缓存地址
originalFileString源文件链接
riskTypeInt汇总结果,风险类型,详见 汇总结果解析 - RiskType
suggestionInt汇总结果,处理建议,详见 汇总结果解析 - Suggestion
tasksObject<taskDetail>任务识别结果。每个任务识别结果的 taskDetail 由项目 ID 作为字段,具体任务识别结果作为字段值进行展示。具体任务识别结果请根据识别任务类型参考 识别接口文档返回结果

2.3 响应示例

{
"json": "{\"code\":0,\"data\":[{\"id\":\"nY4QB4UB9PvLs933Ua3x\",\"secretId\":\"**************\",\"originalFile\":\"**************\",\"createTime\":\"2022-12-12T23:59:48.203+08:00\",\"riskType\":0,\"suggestion\":0,\"tasks\":{\"test_5c2d704a40afc86c979b\":{\"secretTaskId\":\"test_5c2d704a40afc86c979b\",\"taskDescId\":\"5ad37309616505867eeac264\",\"trainRecordId\":\"5c50387fff446cb0d7e91cfd\",\"labelRate\":0.9235546588897705,\"label\":9,\"images\":10,\"avgScores\":[{\"score\":0.5062792062759399,\"label\":9},{\"score\":0.10994690954685211,\"label\":7},{\"score\":0.041435074806213376,\"label\":2}],\"maximums\":[{\"max\":0.9235546588897705,\"label\":9},{\"max\":0.6127519011497498,\"label\":7},{\"max\":0.4143507480621338,\"label\":2}],\"statistics\":[{\"label\":9,\"count\":7},{\"label\":7,\"count\":2},{\"label\":2,\"count\":1}]}}}],\"hasNext\":true,\"message\":\"success\",\"nonce\":0.16201345965833908,\"timestamp\":1670905169,\"total\":77462}",
"signature": "NQJvDTb5KJn2Izi+oBAg3x6xwrokC24VXEerv6wLyksgcoIMUOxmka+h73wh78p4FSxp6kh55vrTY85vD9x1YQTLMg6tFqH1hrEezSMLKOvsU1UEmT4oKA2uxDobYXjSEwG/H1O1Lc9a++70zNE6+xbM17WbDVIlRpw4tjlT3qY="
}

json 字段示例


{
"code": 0,
"data": [
{
"id": "nY4QB4UB9PvLs933Ua3x",
"secretId": "**************",
"originalFile": "**************",
"createTime": "2022-12-12T23:59:48.203+08:00",
"riskType": 0,
"suggestion": 0,
"tasks": {
"test_5c2d704a40afc86c979b": {
"secretTaskId": "test_5c2d704a40afc86c979b",
"taskDescId": "5ad37309616505867eeac264",
"trainRecordId": "5c50387fff446cb0d7e91cfd",
"labelRate": 0.9235546588897705,
"label": 9,
"images": 10,
"avgScores": [
{
"score": 0.5062792062759399,
"label": 9
},
{
"score": 0.10994690954685211,
"label": 7
},
{
"score": 0.041435074806213376,
"label": 2
}
],
"maximums": [
{
"max": 0.9235546588897705,
"label": 9
},
{
"max": 0.6127519011497498,
"label": 7
},
{
"max": 0.4143507480621338,
"label": 2
}
],
"statistics": [
{
"label": 9,
"count": 7
},
{
"label": 7,
"count": 2
},
{
"label": 2,
"count": 1
}
]
}
}
}
],
"hasNext": true,
"message": "success",
"nonce": 0.16201345965833908,
"timestamp": 1670905169,
"total": 77462
}