> For the complete documentation index, see [llms.txt](https://testindata.gitbook.io/dataset/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://testindata.gitbook.io/dataset/open-api/data.md). # 获取数据 ### 获取文件列表数据 > POST http\://{{host}}/v1/dataset/{{dataset\_id}}/data **请求参数** 注意：如使用检索条件，各检索参数的关系为AND逻辑 | 参数 | 类型 | 是否必传 | 描述 | | -------- | ------ | ---- | ---------------------------------------------------------------------------------- | | offset | int | 是 | 默认0 | | limit | int | 是 | 最大支持1000 | | meta | object | 否 | 根据导入时带入的meta信息进行检索，为k:v格式，如{"city":"beijing","weather":"sunny"}，注，多个meta信息检索为AND逻辑 | | label | string | 否 | 根据标注结果中label信息进行检索 | | sensor | string | 否 | 如为融合数据，可传入此字段筛选对应传感器名称 | | slice | string | 否 | 根据slice子集ID进行检索，注：如果使用slice检索，将忽略其他搜条件 | | filename | string | 否 | 根据文件名称检索，使用前后模糊匹配等同 "%filename%"，若使用此参数查询，除使用slice检索外，将忽略其他搜索条件 | **请求样例** ``` POST http://{{host}}/v1/dataset/{{dataset_id}}/data Content-Type: application/json T-key: {{T-key}} { "offset":0, "limit":100, "meta":{"city":"beijing","weather":"sunny"}, "label":"car", "sensor":"camera_0" } Response: { "code": "", "msg": "", "data": { "total": "1", "files": [ { "fid": "fs_XDTNVZ216xGdnjzxIdSN", "ref_id": "", "name": "文件名", "path": "/default1/path/a.jpg", "url": "/default1/path/a.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%2F20210421%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210421T021600Z&X-Amz-SignedHeaders=&X-Amz-Expires=43200&X-Amz-Signature=372fd9dc078c1486ae26ae7af22c001a82e4911c9a6de9f47d663475ad8ea2d3", "md5": "md5-value", "size": 100, "frame_id": "frame_0001", "sensor": "camera_0", "meta": { "weather": "sunny" }, "create_at": 1618820583, "update_at": 1618820583 } ] } } 无查询结果Response: { "code": "", "msg": "", "data": { "total": 0, "files": [] } } ``` ### ### 获取文件及标注数据详情 支持根据fid或者ref\_id进行查询文件信息及标注结果，使用fid为： > GET http\://{{host}}/v1/dataset/{{dataset\_id}}/fidloc/{{fid}} 使用ref\_id为： > GET http\://{{host}}/v1/dataset/{{dataset*id}}/refloc/{{ref\_id*}} **请求示例** ``` GET http://{{host}}/v1/dataset/{{dataset_id}}/fidloc/{{fid}} Content-Type: application/json T-key: {{T-key}} Response: { "code": "", "msg": "", "data": { "file": { "fid": "fs_XDTNVZ216xGdnjzxIdSN", "ref_id": "", "name": "文件名", "path": "/default1/path/a.jpg", "url": "/default1/path/a.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%2F20210421%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210421T021600Z&X-Amz-SignedHeaders=&X-Amz-Expires=43200&X-Amz-Signature=372fd9dc078c1486ae26ae7af22c001a82e4911c9a6de9f47d663475ad8ea2d3", "md5": "md5-value", "size": 100, "frame_id": "frame_0001", "sensor": "camera_0", "meta": { "weather": "sunny" }, "create_at": 1618820583, "update_at": 1618820583 }, "anotations": [ { "ano_id": "ano_fr4LuSh9qCXFUYL1Jo9x", "label": "car", "instance": "instance-id", "type": "box2d", "attrs": { "truncate": true }, "index":0, "data": { "x": 21.31, "y": 33.22, "width": 210, "height": 122 } } ] } } ``` ### 融合数据获取文件及标注数据详情 支持根据fid或者ref\_id进行查询与文件同一帧的融合数据的文件及标注结果，使用fid为： > GET http\://{{host}}/v1/dataset/{{dataset\_id}}/fidloc/{{fid}}/fusion 使用ref\_id为： > GET http\://{{host}}/v1/dataset/{{dataset*id}}/refloc/{{ref\_id*}}/fusion **请求示例** ``` GET http://{{host}}/v1/dataset/{{dataset_id}}/fidloc/{{fid}}/fusion Content-Type: application/json T-key: {{T-key}} Response: { "code": "", "msg": "", "data": { "pointcloud": { "file": { "fid": "fs_XDTNVZ216xGdnjzxIdSN", "ref_id": "", "name": "文件名", "path": "/default1/path/a.pcd", "url": "/default1/path/a.pcd?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%2F20210421%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210421T021600Z&X-Amz-SignedHeaders=&X-Amz-Expires=43200&X-Amz-Signature=372fd9dc078c1486ae26ae7af22c001a82e4911c9a6de9f47d663475ad8ea2d3", "md5": "md5-value", "size": 100, "frame_id": "frame_0002", "sensor": "pointcloud", "meta": { "weather": "sunny" }, "create_at": 1618831431, "update_at": 1618831431 }, "anotations": [...省略...] }, "camera_0": { "file": { "fid": 771, "ref_id": "", "name": "文件名", "path": "/default1/path/a.jpg", "url": "/default1/path/a.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%2F20210421%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210421T021600Z&X-Amz-SignedHeaders=&X-Amz-Expires=43200&X-Amz-Signature=372fd9dc078c1486ae26ae7af22c001a82e4911c9a6de9f47d663475ad8ea2d3", "md5": "md5-value", "size": 100, "frame_id": "frame_0002", "sensor": "camera_0", "meta": { "weather": "sunny" }, "create_at": 1618831432, "update_at": 1618831432 }, "anotations": [...省略...] }, "camera_1": { "file": { "fid": 772, "ref_id": "", "name": "文件名", "path": "/default1/path/b.jpg", "url": "/default1/path/b.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%2F20210421%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210421T021600Z&X-Amz-SignedHeaders=&X-Amz-Expires=43200&X-Amz-Signature=372fd9dc078c1486ae26ae7af22c001a82e4911c9a6de9f47d663475ad8ea2d3", "md5": "md5-value", "size": 100, "frame_id": "frame_0002", "sensor": "camera_1", "meta": { "weather": "sunny" }, "create_at": 1618831432, "update_at": 1618831432 }, "anotations": [...省略...] } } } ```