接口说明

摔倒检测

本文提供了调用人体人形识别具体接口和参数说明。温馨提示:调用此服务API需登录智汇云官网进行开通,https://zyun.360.cn/manage

接口名

/v1/faceid/fellDown

请求域名

ai.zyun.360.cn

功能描述

检测视频中是否有人摔倒

通讯协议

支持通过HTTP协议进行请求通信

请求方式

支持post方式发送请求

请求参数

Header头中传递的参数

参数 参数名 参数描述
Authorization 鉴权信息 鉴权信息规则参见下方规则详细描述。
Auth-Time 当前时间 规则参见下方详细描述。
Rand-Num 随机数 规则参见下方详细描述。
Auth-Ver 版本号 固定值:1.0

header认证参数说明

参数名称 说明 用法
Authorization 认证字符串 生成第一步:将AK、auth_time、rand_num、param_sign 拼接成一个字符串、中间用”\n”分隔。第二步:用SK对第一步生成的字符串做sha1加密,生成authorization
Auth-Ver 认证版本 1.0
Auth-Time 认证时间 表示此次操作的时间,unix系统时间戳(10位)(不能为空,如果请求中的Auth-Time时间和服务器的时间差15分钟以上,服务器将拒绝该服务,并返回ERROR错误)
Rand-Num 随机正整数 表示一个随机正整数(rand生成即可)

Authorization生成规则

  1. $auth_time = time();
  2. $auth_string = $ak . "\n" . $auth_time . "\n" . $rand_num . "\n" . $param_sign;
  3. $encrypt_string = base64_encode(hash_hmac("sha1", $auth_string, $sk, true));
  4. $authorization = $ak . ":" . $encrypt_string;

构造密码串

参数说明 参数名称 说明 用法
auth_time unxi时间戳(10位)
ak Access Key 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey
sk Secret Access Key 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey
rand_num 随机正整数
param_sign 参数按键排序并加入随机因子 所有参数按key做升序排序后串成字符串$paramStr,然后 $paramStr的md5值连上$rand_num,然后再用md5计算得到的值为param_sign paramStr排序例子: 参数 { a1:v1, b1:v3, a2:v2 } 排序后的字符串为 a1=v1a2=v2b1=v3

body中传递的参数(post)

参数名称 必选 类型 参数说明
app_id true string 用户在控制台创建的应用ID
video_url true string 视频URL(必须保证地址可访问)

返回结果说明

参数名称 类型 参数说明
falls float 跌倒的得分(-10,10)
normal float 非跌倒的得分(-10,10
errcode int 错误码
errmsg string 错误描述

备注:falls 得分大于normal 为跌倒,否则为非跌倒。

同步响应示例

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "data": {
  5. "action_result": [
  6. {
  7. "falls": 0.8217751383781433,
  8. "normal": -0.729843020439148
  9. }
  10. ]
  11. }
  12. }

错误码说明

错误码 说明
0 正常
400001 未知错误
400002 系统内部错误
400003 签名错误
400004 参数错误
440244 视频URL格式错误
447100 视频url无效或读取不成功
447101 文件不存在
447102 视频过短
447103 视频过小
即刻开始使用

只需完成注册与实名认证,即可体验我们的贴心服务