API：让系统按需获取数据

系统只需要一条或少量结果时，可以按条件请求已发布数据，不必每天搬运整批文件。

API请求响应业务日期

核心概念

API 用稳定的输入参数和输出字段，让系统按条件获取已发布结果。它描述的是访问方式，不自动承诺实时数据。

只查一个机构，不必搬运整批文件

业务页面只想显示杭州分行在 2026-09-30 的存款余额。它可以发送一个带有机构和业务日期的请求：

`GET /api/deposit-balances?branch_id=HZ01&business_date=2026-09-30`。

服务返回这一条已发布记录，调用方只需要理解请求参数和响应字段，不需要知道余额在数仓里经历了哪些加工步骤。

API 模式 · 请求与响应

选择机构和业务日期后发送请求，观察同一份已发布存款余额如何按条件返回为 JSON。

正在加载交互实验…

调用方需要知道 `branch_id` 和 `business_date` 的含义，服务方需要稳定返回 `branch_id`、`business_date`、`deposit_balance` 和 `currency`。字段名、类型和日期语义一旦随意变化，调用方就无法可靠消费。

鉴权、错误码、分页等是真实 API 通常还会考虑的内容。这里把范围收在最小的请求与响应契约内。