加载中…
基础与公共接口

本组说明

基础与公共接口是所有客户端接入的"第一公里":应用启动时拉哪些配置、多语言文案从哪来、验证码怎么发、搜索怎么调,都归本组。它们几乎都是公开接口(无需令牌),可以放心在应用初始化阶段调用。

包含内容

  • 启动配置:bootstrap — 站点信息、导航、语言版本、系统版本(应用启动第一个调用);
  • 多语言包:lang — 全站语言包键值对,带 ETag 协商缓存;
  • 首页聚合:index — 站点首页一次性聚合数据;
  • 验证码:captcha — 图形令牌对与短信/邮件验证码下发(注册、登录共用,详见《鉴权与会话》);
  • 搜索:search — 跨模块全局搜索;
  • 单页内容:page — 单页(关于我们、服务条款等)内容读取。

使用建议

  • 应用启动顺序:先 bootstrap(拿站点配置与导航),再按需 lang(本地缓存译文);
  • lang 支持 ETag/If-None-Match 协商缓存,二次请求返回 304 可省流量,客户端务必实现;
  • captcha/token 与 captcha/verification 是成对流程接口,配合《鉴权与会话》的流程图使用;
  • 其余模块文档中凡提到"登录后个性化"的接口(鉴权级别=可选),可带令牌调用以获得增强数据。
添加日期:2026-10-06