REITs TechDeveloper进入 UI Studio
UI 蓝图/采集后台 · 控制面/公开 API 配置与消费者参考
TARGETF4Admin · 公开数据 API owner、消费方开发者与平台安全人员

公开 API 配置与消费者参考

把 CURRENT 同源只读接口、参数、响应和应用内防爬配置清楚呈现，不包装成不存在的网关或计费产品

/admin/public-apidata-sources对照 CURRENT · data-public-api →
UI STUDIOtarget-data-public-api
Admin1440 × 900100%
100%
/admin/public-api
TARGET UI1440 × 900FIT 100%
CONTENT DATA / PUBLIC-API公开 API 配置与消费者参考
API HEALTHYOP
F4 TARGET · CURRENT API BOUND真实字段与动作来自 Vue/Go 主干；数字、趋势和详情内容为 STRUCTURE SAMPLE。
PUBLIC DATA BOUNDARY

公开 API 配置与消费者参考

当前主干提供同源只读文档、素材、选项与搜索同步接口；配置页不冒充完整 API 网关。

接口目录 · CURRENT

GET/api/v1/documents文档列表

GET/api/v1/documents/{id}文档详情

GET/api/v1/media-assets素材元数据

GET/api/v1/options公开枚举

GET/api/v1/search/documents搜索同步

ENDPOINT · CURRENTGET /api/v1/documents
ParametersResponseErrors
NAMETYPEDEFAULTDESCRIPTION
pageinteger1页码
page_sizeinteger20最大 100
source_idstring—来源筛选
qstring—标题/正文检索
curl 'https://worker.reits.tech/api/v1/documents?page=1&page_size=20'-H 'User-Agent: reits-consumer/1.0'
访问与防爬配置

CORS allowlist2 exact origins · wildcard disabledENFORCED

Rate limit60 rpm · burst 20 · per client IPENABLED

User-Agent requiredblank and 4 patterns blockedREVIEW

Schema versionno explicit public version headerGAP

CURRENT 是应用内防护，不是独立 API Gateway、Key 管理或计量计费系统。

REFERENCE VIEWPORT1440 × 900Desktop first · responsive
PRIMARY TASK打开 endpoint主操作、权限与完成反馈必须同屏可验证
DATA CONTRACTReadonlyDocumentAPIready / loading / empty / error 使用同一 fixture
ACCESSIBILITYKeyboard + WCAG AA焦点顺序、可读名称、对比度进入 UI CI
VISUAL BASELINETARGET · 2026-07-17桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

可以直接拆成开发任务的目标定义

目标稿与当前实现严格分轨；只有产品仓实现、测试与生产证据齐全后，才会转为 current evidence。

01

页面区域

  • 接口导航
  • Endpoint 参考
  • 可复制请求
  • 访问控制
  • 限流状态
  • 版本缺口
  • 保存回执
02

用户动作

  • 打开 endpoint
  • 复制请求
  • 查看响应
  • 刷新配置
  • 保存 allowlist
  • 更新防爬策略
  • 查看审计
03

必须状态

  • 工作台就绪
  • 模块数据加载
  • 当前范围为空
  • 部分 API 或依赖失败
  • 页面读取失败
  • 离线只读快照
  • 操作权限不足
  • 高影响操作确认
  • 操作回执
04

数据契约

  • ReadonlyDocumentAPI
  • ReadonlyMediaAPI
  • PublicOptionsAPI
  • SearchSyncAPI
  • PublicApiSettings
  • AntiCrawlerPolicy
  • CorsPolicy
  • ApiSchemaRevision

TARGET MODULES

目标页面必须交付的模块

  1. 01CURRENT endpoint 目录
  2. 02参数与响应
  3. 03CORS allowlist
  4. 04Rate limit
  5. 05User-Agent 策略
  6. 06IP/CIDR 黑名单
  7. 07Schema 版本
  8. 08弃用与状态

PRODUCT ROUTE INDEX

采集后台 · 控制面 的 30 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言，但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

01
采集概览/admin/overview
Admin02
采集源管理/admin/sources
Admin03
运行日志/admin/logs
Admin04
素材资产/admin/media
Admin05
分类管理/admin/topics
Admin06
来源发现/admin/discovery
Admin07
采集规则/admin/rules
Admin08
采集策略/admin/settings
Admin09
备份恢复/admin/backups
Admin10
系统资源/admin/resources
Admin11
审计日志/admin/audit
Admin12
采集内容/admin/documents
Admin13
BBS 发帖候选/admin/bbs
Admin14
合规复核/admin/compliance
Admin15
公开 API 目录/admin/public-api
Admin16
采集运行总览与行动队列/admin/overview
Admin17
分类树、绑定与影响治理/admin/topics
Admin18
候选源发现、探测与接入判定/admin/discovery
Admin19
采集源注册表与责任详情/admin/sources
Admin20
解析规则 Studio 与样本验证/admin/rules
Admin21
三级策略、调度与容量模拟/admin/settings
Admin22
运行、阶段、事件与恢复探索器/admin/logs
Admin23
备份校验、恢复演练与故障域/admin/backups
Admin24
系统容量、Worker 与依赖健康/admin/resources
Admin25
不可变审计事件与对象差异/admin/audit
Admin26
文档索引、版本与来源快照/admin/documents
Admin27
BBS 候选审核、路由与发布回执/admin/bbs
Admin28
素材下载、解析与使用边界/admin/media
Admin29
来源政策证据与合规 Casework/admin/compliance
Admin30
公开 API 配置与消费者参考/admin/public-api
Admin
← 来源政策证据与合规 Casework行情数据指挥中心 →