频率限制
StablePay API 实施频率限制以确保所有用户的公平使用和 API 稳定性。
默认限制
| 环境 | 限制 | 说明 |
|---|---|---|
| 测试环境 | 25 req/s | 用于开发测试 |
| 生产环境 | 100 req/s | 标准商户限制 |
| 企业版 | 500+ req/s | 可申请更高限额 |
响应头
每个 API 响应都包含频率限制信息：
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1609459200
超限处理
当超过频率限制时，API 返回 429 Too Many Requests：
{
"error": {
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please retry after 60 seconds.",
"retry_after": 60
}
}
最佳实践
- 实现指数退避 - 遇到 429 错误时等待后重试
- 缓存响应 - 减少不必要的 API 调用
- 批量操作 - 使用批量 API 减少请求次数
- 监控使用量 - 关注
X-RateLimit-Remaining头