ODRIVA / HTTPS API

连接已有数据

用脚本、网关或已有系统上传数据，在工作台查看来源、历史指标和分析。先从一个测试来源开始。

开发与 staging 入口，需已有账号或人工开通。云端完整验收尚未完成。

创建来源
登录后添加获授权的通用数据资产，创建数据空间，在“数据连接与历史指标”选择 API 来源。测试来源开启 synthetic，并声明 cpu、memory 的单位为 %。
保存专用凭据
创建后保存只显示一次的来源凭据和 ingest endpoint。凭据绑定来源与工作区，可轮换或撤销。不要放进 URL、共享脚本或日志。
发送测试数据
下载 Python 3.11+ 示例。下方命令适用于 Bash：运行 read 后输入凭据并按回车，替换 <source-id>。脚本只用标准库，生成合成 CPU/内存数据，不读取真实机器性能。
```
read -rs ODRIVA_SOURCE_TOKEN
export ODRIVA_SOURCE_TOKEN
python3 upload-source-samples.py \
  --endpoint 'https://heineda.seletatech.com/api/odriva/v1/sources/<source-id>/events' \
  --outbox ./odriva-source-outbox.db --duration 900 --interval 5
```
脚本在本地 SQLite 保存待发送数据，只在收到逐项持久确认后删除。中断后使用相同 endpoint 和 outbox 重跑；--duration 0 只补传。错误会保留队列，退出非零，请勿删除队列来“完成”测试。
检查历史
上传持续 15 分钟后，在同一工作区选择来源，查看 CPU、内存曲线、单位、质量和接收时间，也可下载历史 JSON。停止发送后历史保留，来源随时间显示陈旧。

接入合同

POST /api/odriva/v1/sources/<source-id>/events；schemaVersion 为 odriva.source.v1。样本包含稳定非负 sequence、带时区的 observedAt、已声明的 values 和 quality。最多 500 条/批、2 MiB；示例每批最多 50 条。synthetic 必须与来源声明一致，null 表示缺测。

202 表示持久接受，逐项返回 INSERTED 或 DUPLICATE；不表示分析投影已完成。重试保留原序号、时间和值。403 检查权限和凭据；409 检查身份内容冲突；422 检查映射或格式；429/503 按 Retry-After 重试。

用 curl 发送一条样本

另外创建一个新的测试来源，重新用 read 设置对应凭据并替换 endpoint；不要与持续脚本共用序号。重试只重复 curl 部分，不重新生成 sample.json；新的样本递增序号。

python3 - <<'PY' > sample.json
import json
from datetime import UTC, datetime
print(json.dumps({"schemaVersion": "odriva.source.v1", "synthetic": True,
    "samples": [{"sequence": 1, "observedAt": datetime.now(UTC).isoformat(),
    "values": {"cpu": 25, "memory": 50}, "quality": "good"}]}))
PY
printf 'header = "Authorization: Bearer %s"\n' "$ODRIVA_SOURCE_TOKEN" | \
  curl --config - --fail-with-body --header 'Content-Type: application/json' \
  --data-binary @sample.json \
  'https://heineda.seletatech.com/api/odriva/v1/sources/<source-id>/events'

已有系统与连接器

现有网关可把 OPC UA 或 MQTT 数据映射后转发 HTTPS；本轮不提供通用 OPC UA client 或原生 MQTT broker。REST/OAuth 入口目前只提供明确标注的参考测试平台。OAuth 授权不等于 PLC 适配，真实供应商支持需独立验证。

当前范围

历史原始样本默认保留 30 天，单次窗口最多 30 天、5000 条，截断时缩小范围。每工作区最多 100 个未撤销来源，租户还受部署总量限制；暂停仍占名额。没有可供下载的新 Windows 安装包，现有 Edge 接入为可选路径。

连接已有数据

创建来源

保存专用凭据

发送测试数据

检查历史

接入合同

用 curl 发送一条样本

已有系统与连接器

当前范围