water/server/public/docs/mini/index.html

<!doctype html>
<html lang="zh-CN">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="referrer" content="same-origin">
    <title>云泉智配 · 小程序接口文档</title>
    <link rel="stylesheet" href="./vendor/swagger-ui.css">
    <link rel="stylesheet" href="./docs.css">
    <script defer src="./vendor/swagger-ui-bundle.js"></script>
    <script defer src="./docs.js"></script>
  </head>
  <body>
    <header class="masthead">
      <div class="container heading">
        <div>
          <p class="eyebrow">云泉智配 / 开发者文档</p>
          <h1>小程序 API <span>v1</span></h1>
          <p class="subtitle">企业端 · 司机端 · 代理端</p>
        </div>
        <a class="download" href="./openapi.json" download="water-mini-v1.json">下载 OpenAPI</a>
      </div>
    </header>
    <main>
      <section class="container introduction" aria-label="接入指南">
        <div class="endpoint"><span>当前接口地址</span><code id="base-url">加载中…</code></div>
        <div class="status-row">
          <span id="operation-count">正在读取接口目录</span>
          <span id="service-status" role="status">正在检查服务状态…</span>
          <button id="refresh-status" type="button">刷新状态</button>
        </div>
        <details class="guide" open>
          <summary>开始调用</summary>
          <ol>
            <li>展开「公共与登录」中的 <code>GET /health</code> 或 <code>GET /config</code>，点击 <strong>Try it out → Execute</strong>，即可测试公开接口。</li>
            <li>微信登录需要后端配置 AppID 和 Secret。用 <code>wx.login()</code> 获取真实 code，调用 <code>POST /auth/wechat</code>，取得 <code>access_token</code>。</li>
            <li>点击下方 <strong>Authorize</strong>，只粘贴 access_token，无需填写 Bearer 前缀。首次登录需由后台绑定企业、司机或代理身份；后台管理员 Token 不适用。</li>
            <li>业务请求使用实际授权的资源 ID。写接口的 <code>request_key</code> 每次新操作使用新值；重试同一次操作使用原值与原参数。金额单位为分，时间为上海时间。</li>
          </ol>
          <p>在线调试会调用真实接口，提交前请核对参数。Token 仅保留在当前页面内存中，刷新后需重新填写。</p>
        </details>
        <p class="notice"><strong>能力说明：</strong>支付、余额支付、佣金、提现、邀请奖励和设备绑定尚未开放，以 <code>/config</code> 为准。手机号验证码登录仍在设计中，暂未提供可调用接口。</p>
        <p class="hint">页面默认调用当前域名下的服务。手机联调使用可访问的 HTTPS 域名；异地部署需配置精确的文档来源白名单。</p>
        <p id="load-error" class="error" role="alert" hidden></p>
      </section>
      <section id="swagger-ui" aria-label="接口目录与在线调试"></section>
      <noscript><p class="container error">请启用 JavaScript 查看接口目录。也可以下载 OpenAPI 文件导入 Apifox。</p></noscript>
    </main>
    <footer class="container footer">接口定义来自项目 OpenAPI · Swagger UI 5.33.0 · <a href="./vendor/LICENSE">开源许可</a></footer>
  </body>
</html>