# 获取数据 ### 获取文件列表数据 > 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": [...省略...] } } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://testindata.gitbook.io/dataset/open-api/data.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.