Getting Started
接入指南：从注册到第一次调用
data·hub 是面向人和 AI agent 的结构化数据 API。拿一个 key、记一个 header，五分钟内完成第一次调用。
01拿到 API key（免费，自助）
- 注册账号：邮箱收验证码即可开通，无需审核。
- 登录后进入 控制台 → API Keys，点「生成新 key」。
- 复制保存明文 key（形如
dh_xxxxxxxx…）。明文只展示这一次，服务端只存哈希；丢了就吊销旧的再生成。
自助 key 默认带全部数据集的读取权限，每账号最多 5 个有效 key，可随时吊销。
02第一次调用
所有数据接口都在 https://api.lumina-core.cn/v1/*，认证只有一件事：请求头带 X-API-Key。
$ curl -H "X-API-Key: <your key>" \
"https://api.lumina-core.cn/v1/news?q=新能源&limit=10"响应是 JSON：列表接口统一返回 { total, limit, offset, items }； 带 q 检索时默认返回命中片段 snippet（省上下文）， 要整段正文在 fields 里显式加 content。
03四个数据集
newsCCTV《新闻联播》
GET /v1/news?q=新能源ycY Combinator 公司目录
GET /v1/yc/companies?tag=AIpolicy国务院政策文件库
GET /v1/policy?q=人工智能opinion人民日报评论语料
GET /v1/opinion?q=基层治理每个数据集都支持：全文检索（GET 单短语；POST /search 多词 AND/OR/短语）、字段投影、时间区间过滤、维度聚合（group_by， 画趋势曲线）。字段与端点明细见各数据集页， 精确参数以 openapi.json 为准。
04限流、免费额度与错误码
每个 key 两道闸：限流管瞬时速率（默认 60 次/分），日配额管每日总量（公测期免费 1000 次/天，北京时间次日 0 点重置）。 被拒的请求（401/403/429）不消耗配额；当日用量在控制台 → 用量随时可查。
401缺少 / 无效 / 已吊销的 key检查 X-API-Key 头；必要时到控制台重新生成
403key 没有该数据集的权限控制台自助 key 默认带全部数据集 read 权限
429（限流）瞬时请求过快（默认 60 次/分）按响应头 Retry-After 秒数稍候重试
429（配额）当日免费额度用尽（默认 1000 次/天）北京时间次日 0 点自动重置；更高额度后续开放申请
05给 AI Agent
把一个 key 和一个链接交给 agent 即可自助接入，三层入口由浅入深：
- https://api.lumina-core.cn/llms.txt极简 Markdown 概览，读完就能开始调
- https://api.lumina-core.cn/openapi.json完整机器可读契约（事实源）
- https://api.lumina-core.cn/docsScalar 交互文档，给人看