更新时间:2024-02-06 GMT+08:00
分享

获取数据片段列表

功能介绍

获取数据片段列表

URI

GET /v1.0/{project_id}/data/episodes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id,获取方法请参见获取项目ID

表2 Query参数

参数

是否必选

参数类型

描述

start_time

Long

起始时间,UTC标准时间毫秒时间戳

最小值:1000000000000

最大值:2000000000000

end_time

Long

结束时间,UTC标准时间毫秒时间戳

最小值:1000000000000

最大值:2000000000000

dpk_id

String

数据包ID,支持通配模糊查询

最大长度:255

vehicle_name

String

车辆名称,只支持精确匹配查询

最大长度:64

limit

Integer

返回个数上限

最小值:1

最大值:200

缺省值:10

offset

Integer

查询偏移量

最小值:0

缺省值:0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

payload

DataEpisodesPayload object

实际返回信息

meta_info

RespMetaInfo object

元数据

表5 DataEpisodesPayload

参数

参数类型

描述

list

Array of DataEpisodeMeta objects

片段列表

page_info

PageInfo object

分页信息

表6 DataEpisodeMeta

参数

参数类型

描述

episode_id

String

片段ID

dpk_id

String

数据包ID

vehicle_name

String

车辆名称

start_time

Long

开始时间,UTC标准时间毫秒时间戳

end_time

Long

结束时间,UTC标准时间毫秒时间戳

can_replay

Boolean

是否可以回放

main_topics

DataMainTopics object

主要的topic信息

表7 DataMainTopics

参数

参数类型

描述

gnss

DataTopicInfo object

gnss信息

camera

DataTopicInfo object

camera信息

表8 DataTopicInfo

参数

参数类型

描述

topic

String

topic

type

String

类型

path

String

路径

表9 PageInfo

参数

参数类型

描述

offset

Integer

查询偏移量

limit

Integer

返回个数上限

total

Integer

资源总数

表10 RespMetaInfo

参数

参数类型

描述

current_time

String

请求时间,UTC时间格式,时间为UTC标准时间

请求示例

获取数据片段列表

https://{endpoint}/v1.0/{project_id}/data/episodes?start_time=1000000000000&end_time=1640966400000&dpk_id=DPK0000001

响应示例

状态码: 200

查询成功

{
  "meta_info" : {
    "current_time" : "2022-01-01T08:08:29Z"
  },
  "payload" : {
    "list" : [ {
      "episode_id" : "DPK0000001",
      "dpk_id" : "DPK0000001",
      "vehicle_name" : "myCar",
      "start_time" : 1640966400000,
      "end_time" : 1640966500000,
      "main_topics" : {
        "gnss" : {
          "topic" : "gnss",
          "type" : "GNSS",
          "path" : "DPK0000001/path/gnss/gnss.pb"
        },
        "camera" : {
          "topic" : "camera_0",
          "type" : "CAMERA",
          "path" : "DPK0000001/path/camera_0/"
        }
      },
      "can_replay" : true
    } ],
    "page_info" : {
      "offset" : 0,
      "limit" : 10,
      "total" : 1
    }
  }
}

状态码

状态码

描述

200

查询成功

400

请求参数错误

403

权限校验失败

500

系统内部错误

错误码

请参见错误码

相关文档