本组说明
基础与公共接口是所有客户端接入的"第一公里":应用启动时拉哪些配置、多语言文案从哪来、验证码怎么发、搜索怎么调,都归本组。它们几乎都是公开接口(无需令牌),可以放心在应用初始化阶段调用。
包含内容
- 启动配置:
bootstrap— 站点信息、导航、语言版本、系统版本(应用启动第一个调用); - 多语言包:
lang— 全站语言包键值对,带 ETag 协商缓存; - 首页聚合:
index— 站点首页一次性聚合数据; - 验证码:
captcha— 图形令牌对与短信/邮件验证码下发(注册、登录共用,详见《鉴权与会话》); - 搜索:
search— 跨模块全局搜索; - 单页内容:
page— 单页(关于我们、服务条款等)内容读取。
使用建议
- 应用启动顺序:先
bootstrap(拿站点配置与导航),再按需lang(本地缓存译文); lang支持 ETag/If-None-Match 协商缓存,二次请求返回 304 可省流量,客户端务必实现;captcha/token与captcha/verification是成对流程接口,配合《鉴权与会话》的流程图使用;- 其余模块文档中凡提到"登录后个性化"的接口(鉴权级别=可选),可带令牌调用以获得增强数据。