> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cbpayapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Postman

> 可直接导入的集合，用于试用整个 API

export const PostmanFreshness = ({iso, lang = "es"}) => {
  const [now, setNow] = useState(() => Date.now());
  useEffect(() => {
    const t = setInterval(() => setNow(Date.now()), 1000);
    return () => clearInterval(t);
  }, []);
  const ts = new Date(iso).getTime();
  if (!iso || Number.isNaN(ts)) {
    return null;
  }
  const secs = Math.max(0, Math.floor((now - ts) / 1000));
  const UNITS = {
    en: [[31536000, "year", "years"], [2592000, "month", "months"], [86400, "day", "days"], [3600, "hour", "hours"], [60, "minute", "minutes"], [1, "second", "seconds"]],
    es: [[31536000, "año", "años"], [2592000, "mes", "meses"], [86400, "día", "días"], [3600, "hora", "horas"], [60, "minuto", "minutos"], [1, "segundo", "segundos"]],
    zh: [[31536000, "年", "年"], [2592000, "个月", "个月"], [86400, "天", "天"], [3600, "小时", "小时"], [60, "分钟", "分钟"], [1, "秒", "秒"]]
  };
  const units = UNITS[lang] || UNITS.es;
  let rel;
  for (const [size, one, many] of units) {
    if (secs >= size || size === 1) {
      const n = Math.floor(secs / size);
      const unit = n === 1 ? one : many;
      rel = lang === "en" ? `${n} ${unit} ago` : lang === "zh" ? `${n}${unit}前` : `hace ${n} ${unit}`;
      break;
    }
  }
  const label = lang === "en" ? `Updated ${rel}` : lang === "zh" ? `更新于${rel}` : `Actualizada ${rel}`;
  return <p className="text-sm text-gray-500 dark:text-zinc-400">
      <strong>{label}</strong>
    </p>;
};

下载官方 CBPay Postman 集合，它由支撑本文档的同一份 OpenAPI 规范生成：涵盖所有端点，每个用例一个请求（对应规范中的每个命名示例），每个操作一个已保存的响应。

<Card title="CBPay API — Postman 集合" icon="download" href="/postman/cbpay-api.postman_collection.json">
  下载 `cbpay-api.postman_collection.json`（v2.1）
</Card>

> **集合更新时间：** 2026-07-18 19:19 UTC · 252 个请求 · 版本 `a4f0a3b6ae5b`

<PostmanFreshness iso="2026-07-18T19:19:00Z" lang="zh" />

## 如何使用

<Steps>
  <Step title="导入集合">
    在 Postman 中：**Import** → 拖入下载的文件。
  </Step>

  <Step title="设置变量">
    集合自带两个变量：

    | 变量        | 值                                      |
    | --------- | -------------------------------------- |
    | `baseUrl` | `https://api.qbank.cl/platform`（已预先配置） |
    | `token`   | 您的会话 JWT 或 `pk_...` API 密钥             |
  </Step>

  <Step title="开始试用">
    每个请求都通过 `{{token}}` 继承 Bearer 认证。先用 `GET /v1/me` 验证您的凭证，再用 `GET /v1/balances` 查看您的余额。
  </Step>
</Steps>

<Note>
  集合会随每个 API 版本重新生成——每次[更新日志](/zh/changelog)有新条目后请重新下载，以获取最新端点。
</Note>