fix(api): synchronize hydraulic playback binary contract
Generic Container CI/CD / test-build-publish (push) Failing after 2m11s
Server CI/CD v2 / build-test-publish-and-deploy (push) Failing after 2m11s

This commit is contained in:
2026-11-15 23:43:13 +08:00
parent f5f972bbec
commit cac43ad734
4 changed files with 254 additions and 3 deletions
+1 -1
View File
@@ -3,7 +3,7 @@
"contracts": {
"server": {
"file": "server-v1.openapi.json",
"sha256": "9801087d40ac0e1f67871f9a1db850cbcce47614cceec0a7e8771cdf58385f53"
"sha256": "04aeed6f1a7414b37267d84141d036d00d2f8579ee28af37590bd4b92137e712"
}
}
}
+240
View File
@@ -50912,6 +50912,246 @@
]
}
},
"/api/v1/timeseries/realtime/playback/frames": {
"get": {
"operationId": "get_timeseries_realtime_playback_frames",
"parameters": [
{
"in": "query",
"name": "start_time",
"required": true,
"schema": {
"title": "Start Time",
"type": "string"
}
},
{
"in": "query",
"name": "model_version",
"required": true,
"schema": {
"maxLength": 24,
"minLength": 24,
"title": "Model Version",
"type": "string"
}
},
{
"in": "query",
"name": "frame_count",
"required": false,
"schema": {
"default": 4,
"maximum": 8,
"minimum": 1,
"title": "Frame Count",
"type": "integer"
}
},
{
"in": "query",
"name": "step_seconds",
"required": false,
"schema": {
"default": 900,
"maximum": 3600,
"minimum": 60,
"title": "Step Seconds",
"type": "integer"
}
},
{
"in": "header",
"name": "X-Project-Id",
"required": true,
"schema": {
"title": "X-Project-Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/octet-stream": {
"schema": {
"format": "binary",
"type": "string"
}
}
},
"description": "Versioned little-endian Float32 packet"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Authentication required"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Insufficient permission"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Resource not found"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Resource conflict"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Validation error"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Dependency unavailable"
}
},
"security": [
{
"OAuth2PasswordBearer": []
}
],
"summary": "读取索引一致的 Float32 水力时间块",
"tags": [
"TimescaleDB - Hydraulic Playback"
]
}
},
"/api/v1/timeseries/realtime/playback/geometry": {
"get": {
"operationId": "get_timeseries_realtime_playback_geometry",
"parameters": [
{
"in": "header",
"name": "X-Project-Id",
"required": true,
"schema": {
"title": "X-Project-Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/octet-stream": {
"schema": {
"format": "binary",
"type": "string"
}
}
},
"description": "Versioned little-endian Float32 packet"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Authentication required"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Insufficient permission"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Resource not found"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Resource conflict"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Validation error"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Dependency unavailable"
}
},
"security": [
{
"OAuth2PasswordBearer": []
}
],
"summary": "读取带版本的水力专题层静态几何",
"tags": [
"TimescaleDB - Hydraulic Playback"
]
}
},
"/api/v1/timeseries/realtime/records": {
"get": {
"description": "查询指定时间点的实时属性值。query_time 必须显式带时区;允许传 UTC+8,服务端会先归一化为 UTC 再执行查询。",