datadata-rest-apilisted

## 功能概览 本 skill 提供 Datadata REST API 的完整参考文档，通过 `urllib.request`（仅标准库，零额外依赖）展示所有端点的调用方式。 **首要用例**是生成独立 Python 脚本（爬虫、ETL、批处理），但 API 文档本身是通用的 — 任何需要直接调用 Datadata API 的场景均可参考。 > **交互式操作（聊天中执行查询、探索数据等）请使用 `datadata-manual` skill。** MCP 已完整覆盖搜索、查询、Data Spaces 等日常交互功能。 ### 核心能力 - **REST API 参考** — 所有端点的完整说明，含请求/响应示例 - **urllib.request 调用模板** — 即拿即用的 Python 代码片段 - **数据源操作** — 搜索、元信息、表结构、Schema 扫描 - **SQL 查询** — execute-adhoc（只读，异步）、结果下载（NDJSON/CSV） - **Dataspace SQL 执行** — 通过 execute 端点运行任意 DuckDB SQL（建表/写入/改表/删表），同步返回 - **设备授权** — 脚本中自动获取/刷新 API Key ## 使用场景 | 场景 | 示例 | | ----------------- | ---------------------------------------------- | | 生成爬虫脚本 | "帮我写一个爬虫抓取数据写入 Data Space" | | ETL 批处理 | "写个脚本每天从 MySQL 导出数据到 CSV" | | 自动化数据流水线 | "生成脚本定时查询 Datadata 并发送报告" | | 查阅 API 文档 | "Datadata 的 execute-adhoc 接口怎么调？" | | Datadata API 集成 | "给我一个 Python 示例调用 Datadata API 查数据" | > 以下场景请使用 **`datadata-manual`** skill： > > - 聊天中交互式查询数据（"帮我查一下销售数据"） > - 探索数据源结构（"看看这个 datasource 有哪些表"） > - 设置表/列注释、触发扫描等即时操作 ## 概念 - **Datasource** — 查询目标的数据源。不同类型的 datasource（dataspace、MySQL、ClickHouse、CSV 等）有不同的表命名约定。 - **Data space** — 录入数据的目标，`dataspace` 类型 datasource（旧类型名 `ducklake` 已废弃）。通过 `POST /dataspaces/{datasourceId}/execute` 执行任意 DuckDB SQL 来管理表结构与数据。 - **读 / 写分离** — **查询/读取任何数据走 `execute-adhoc`**（查询引擎，把 dataspace 作为只读数据源挂载）；**修改某个 dataspace 内的表结构或数据走 `POST /dataspaces/{id}/execute`**（单一 dataspace，同