Files
tick-stock-panel/examples/open-api/01_pull_market.py
T
shy3130 f20772d7b7 feat(open-api): 开放能力闭环 — write:ext 数据写入 + SSE 事件流 + 契约守护
二开闭环补齐三块: 数据进得来 (写入)、事件推得出 (SSE)、契约有人守 (快照+CI)。

- write:ext scope (第六档): POST /api/ext-data/{id}/ingest 对 Token 开放,
  复用管理端同一校验/落盘/视图刷新路径; 结构配置/上传/拉取仍不开放,
  外部只能写行数据, 不能改写表结构
- SSE 短期票据 (V2 收尾): POST /api/events/ticket 换 60s 一次性票据 →
  GET /api/events?ticket=… 订阅事件流; 票据只继承 Token scope 不放大权限;
  进程内事件总线 (services/events.py, 慢消费者丢旧保新), 告警落盘点已挂
  (alert_store.append/append_many → bus), 事件按 scope 过滤双向验证
- 契约守护: test_openapi_contract.py 冻结 tier=a 开放面 (61 端点),
  增删须显式更新快照; 新增 ci.yml (后端全量测试 + 前端构建) 把契约
  变化拦在 PR 上
- examples/open-api: 四个零依赖可运行示例 (行情/写入/回测/事件流) + README
- 菜单设置架构标注: 每页核心/扩展徽标 + 悬停原因 + 图例 (按 open-platform-plan
  §2 依赖方向分类, 核心 8 页/扩展 11 页); 顺带补上 MenuSettings 缺失的 模拟盘
- 测试: 网关 write矩阵/票据语义 + 票据生命周期/总线/SSE帧/告警联动 + 契约快照,
  全量 2408 passed / 102s; 线上实测: ingest 200 / 票据一次性 / SSE hello+
  alert 推送 / scope 过滤双向 / 契约 61 路径
2026-09-26 11:31:11 +08:00

24 lines
922 B
Python

"""示例 1 — 读行情 (scope: read:market)。
标的搜索 → 拉日K → 市场总览。契约与参数详见 /api/openapi.json?tier=a。
"""
from common import call
# 1. 标的搜索 (支持代码/名称/拼音)
hits = call("GET", "/api/kline/instruments/search?q=600519&limit=3")
for h in hits["results"]:
print(f"搜索命中: {h['symbol']} {h['name']}")
# 2. 贵州茅台 最近 10 根日K (前复权口径)
daily = call("GET", "/api/kline/daily?symbol=600519.SH&limit=10")
rows = daily["rows"]
if rows:
last = rows[-1]
print(f"日K 最近 {len(rows)} 根, 最新 {last['date']} 收盘 {last['close']:.2f}")
else:
print("日K 无数据 — 先在面板「数据」页跑一次同步")
# 3. 市场总览 (快照日期 / 行情源状态)
overview = call("GET", "/api/overview/market")
print("市场总览 as_of:", overview.get("as_of"), "| 行情轮询:", overview["quote_status"]["enabled"])