站点配置与会员状态¶

行情数据只走 POST /api/v1/query。本页剩下的两个接口不是行情：登录页要先知道站点开关，会员中心要读取当前会话的权益。

指数可见范围仍由 visibility 决定，并在统一查询里生效：

visibility	网站身份（不带 API Key）	带 API Key
`private`	不返回	按 Key 的指数范围返回
`index_only`	返回点位，不返回 `weighted_price` 和规格报价	具备 `index:read` / `quote:read` 时返回完整字段
`aggregate`	返回点位、整体价格和规格报价	同上
`member`	仅有效会员与管理员可见	会员 Key 可见；免费 Key 返回 403

不带 Key 的访问使用同一套时效：访客和免费用户默认延迟 7 个交易日，登录会话按会员权益放宽。这类调用不计入 API Key 额度。带了 Key 但 Key 无效、scope 不足或指数不在允许范围时，请求直接失败。

接口列表¶

站点配置¶

1	`GET /api/v1/config`

返回注册开关、网站卡片配置与短信能力开关：

{
  "code": 0,
  "message": "ok",
  "data": {
    "registration_enabled": true,
    "site_url": "https://www.tokease.cn/",
    "site_name": "词易 Token 平台",
    "sms_login_enabled": false,
    "sms_registration_enabled": false,
    "sms_password_reset_enabled": false,
    "sms_international_enabled": false,
    "sms_code_length": 6,
    "sms_resend_seconds": 60,
    "sms_login_resend_seconds": 60
  }
}

字段	说明
`registration_enabled`	是否开放自助注册（`registration.enabled`）
`site_url` / `site_name`	公开站顶部「网站卡片」的名称与链接，由超级管理员在后台维护；未配置时返回内置默认值
`sms_login_enabled`	是否开放手机验证码登录（需短信总开关与国内凭据均已配置）
`sms_registration_enabled`	注册时是否要求短信验证
`sms_password_reset_enabled`	是否开放短信找回密码
`sms_international_enabled`	是否允许 `+国码` 国际号码
`sms_code_length`	验证码位数（默认 6）
`sms_resend_seconds`	注册等场景的验证码发送间隔（秒）
`sms_login_resend_seconds`	登录场景的验证码发送间隔（秒）

前端据此决定是否渲染注册入口、验证码登录与找回密码等界面元素。

会员状态¶

1	`GET /api/v1/membership`

返回当前登录用户（会话 Cookie 可选）的会员权益信息，用于会员中心页面渲染：

字段	说明
`active` / `tier` / `expires_at`	是否有效会员、等级代码、到期时间
`latest`	当前身份是否可查看最新已发布数据
`delay_days` / `cutoff`	免费用户延迟交易日数；当前可见的数据截止日
`first_eligible`	是否仍享有首月优惠资格
`free_benefits` / `benefits`	免费用户与当前身份的实际权益（`api_key_limit`、`api_rate_limit`、`api_daily_limit`、`ip_allowlist`、`member_indices`）
`tiers`	全部会员等级及其权益
`plans`	上架套餐（含 `test_only` 标记，内测套餐仅对相应账号展示）
`payment_enabled` / `methods`	在线支付开关与可用支付方式