Preview a structured query against canonical parquet for one dataset version.
POST
/v1/catalog/dataset-version-queriescurl -X POST 'https://api.embodiflow.io/v1/catalog/dataset-version-queries' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"datasetVersionId": "00000000-0000-0000-0000-000000000000",
"expectedQueryIndexSha256": "string",
"granularity": "episode",
"episodeIndexIn": [
0
],
"episodeIdIn": [
"string"
],
"frameIndexMin": 0,
"frameIndexMax": 0,
"timestampNsMin": "string",
"timestampNsMax": "string",
"featurePredicates": [
{
"path": "string",
"op": "in",
"value": {}
}
],
"metadataEquals": {},
"cameraNameIn": [
"string"
],
"fields": [
"string"
],
"limit": 0,
"offset": 0,
"orderBy": "episodeIndex",
"orderDirection": "asc",
"aggregate": {
"fn": "count",
"field": "string"
}
}'认证
每个请求都需要携带个人访问令牌（PAT）。
- Authorization: Bearer PAT
请求头参数
- Idempotency-Keystring
Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.
请求体
Content-Typeapplication/json
- datasetVersionIdstring (uuid)必填
- expectedQueryIndexSha256string
- granularitystring可选值episodeframe
- episodeIndexInarray<number>
- episodeIdInarray<string>
- frameIndexMinnumber
- frameIndexMaxnumber
- timestampNsMinstring
- timestampNsMaxstring
- featurePredicatesarray<DatasetVersionQueryPredicateBodyDto>
- pathstring必填
- opstring必填可选值inltltegtgteeqneq
- valueobject必填
- metadataEqualsobject
- cameraNameInarray<string>
- fieldsarray<string>
- limitnumber
- offsetnumber
- orderBystring可选值episodeIndextimestampNsframeIndex
- orderDirectionstring可选值ascdesc
- aggregateobject
- fnstring必填可选值count
- fieldstring
响应
Success
- dataobject必填
- datasetVersionIdstring必填
- queryIndexSha256string必填
- granularitystring必填可选值frameepisode
- episodeStatisticsGranularitystring可选值coarse
- rowsarray<object>必填
- totalEstimatenumber | null
- truncatedone of必填
- videoRefsarray<DatasetVersionQueryVideoRefDto>
- elapsedMsnumber必填
- excludedCountnumber
响应示例
{
"data": {
"datasetVersionId": "string",
"queryIndexSha256": "string",
"granularity": "frame",
"episodeStatisticsGranularity": "coarse",
"rows": [
{}
],
"totalEstimate": 0,
"truncated": false,
"videoRefs": [
{
"episodeIndex": 0,
"cameraName": "string",
"storageObjectId": "string",
"logicalPath": "string"
}
],
"elapsedMs": 0,
"excludedCount": 0
}
}服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1