马拉松集锦接口

创建人脸库

接口描述

本接口用于为该用户创建一个人脸库

请求

请求路径

Path	Method	说明
/v1/face/group/create	POST	创建人脸库

请求参数

参数	类型	是否必须	描述
name	String	是	人脸库名称

请求头

无其他特殊头域

请求体

无

响应头域

除公共头域外，无其他特殊头域

响应体

参数	类型	描述
groupId	String	人脸库ID，唯一标识
name	String	人脸库名称
userId	String	用户ID
description	String	人脸库备注
createdTime	String	创建时间
updatedTime	String	更新时间

示例

• 请求示例

  POST /v1/face/group/create?name=test HTTP/1.1
  host: {host}
  content-type: application/json
  authorization: {authorization}

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
  Date: Tue, 08 Now 2023 15:00:00 GMT
  Content-Type: application/json;charset=UTF-8
  
  {
    "groupId": "groupf78288becxxx",
    "name": "test",
    "userId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "description": "百度马拉松测试人脸库",
    "createdTime": "2024-05-24T17:02:12.115709611+08:00",
    "updatedTime": "2024-05-24T17:02:12.115709721+08:00"
    }

添加人脸

接口描述

本接口用于为该用户下的指定人脸库添加一个人脸记录

请求

请求路径

Path	Method	说明
/v1/face/add	POST	添加人脸

请求参数

参数	类型	是否必须	描述
groupId	string	是	人脸库ID
userId	string	是	运动员号码牌

请求头

除公共头域外，无其他特殊头域

请求体

参数	类型	是否必须	描述
face	File	是	人脸图片

响应头域

除公共头域外，无其他特殊头域

响应体

示例

• 请求示例

  POST /v1/face/add?userId=12345&groupId=groupxxxxxxxxxxxxxx HTTP/1.1
  host: {host}
  content-type: application/json
  authorization: {authorization}
  
  face: file:/Users/xxx/Documents/12345.png

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
  Date: Tue, 08 Now 2023 15:00:00 GMT
  Content-Type: application/json;charset=UTF-8
  
  ok

个人集锦接口

接口描述

本接口用于将该马拉松赛事中指定运动员的多个的剪辑视频合成一个集锦视频

请求

请求路径

Path	Method	说明
/v1/event/face_highlights/${eventId}	POST	生成运动员个人集锦视频

请求参数

参数	类型	是否必须	描述
userId	string	是	运动员号码牌

请求头

无其他特殊头域

请求体

无

响应头域

除公共头域外，无其他特殊头域

响应体

参数	类型	描述
higlightId	String	集锦ID，一条集锦的唯一标识

示例

• 请求示例

  POST /v1/event/face_highlights/event-xxxxxxxxxx?userId=12345 HTTP/1.1
  host: {host}
  content-type: application/json
  authorization: {authorization}

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
  Date: Tue, 08 Now 2023 15:00:00 GMT
  Content-Type: application/json;charset=UTF-8
  
  {
    "highlightId": "954498ff-9112-xxxx-bcca-6ceaafcf6216"
  }