限流 - UQPAY Developer Docs

UQPAY 对 API 请求实施限流。限额和计数时间窗口取决于请求类型及环境。

通用限流

请求类型	Endpoint	沙盒	生产
Access Token	`POST /api/v1/connect/token`	每分钟 50 次	每分钟 100 次
除下列 File Service 接口外的其他所有已认证请求	已认证 API 接口	每秒 10 次	每秒 20 次
Upload A File	`POST /api/v1/files/upload`	每秒 5 次	每秒 10 次
Get File Download Links	`POST /api/v1/files/download_links`	每秒 5 次	每秒 10 次

两个文件接口使用 File Service 基础 URL：沙盒为 https://files.uqpaytech.com，生产为 https://files.uqpay.com。

以下 Card Issuance 操作有独立的限流规则，按滚动 60 秒窗口计数。

操作	Endpoint 或集成方式	每个滚动 60 秒窗口的限额
Create PAN Token	`POST /api/v1/issuing/cards/{id}/token`	同账户、同卡最多 10 次；同账户该接口合计最多 1,000 次。任一限额被超过都会触发限流。
Elevate Per-Transaction Limit	`POST /api/v1/issuing/cards/{id}/elevate_limit`	同账户、同卡最多 5 次。
Secure iFrame	通过 Secure iFrame 获取卡片敏感信息	同 IP 最多 100 次，不同卡共享此额度。

超出限额时，API 返回 HTTP 429 Too Many Requests。客户端应处理此状态码，降低请求频率，并采用带随机抖动的指数退避策略重试。对于滚动窗口限流，应等待较早的请求移出计数窗口后再重试。