让程序明确处理每一种结果
错误响应使用稳定的 error 字段。不要依赖中文提示做程序判断，应同时检查 HTTP 状态码与错误代码。
| 状态 | 错误代码 | 处理方式 |
|---|---|---|
| 400 | invalid_query | 参数格式、范围或组合不正确。 |
| 401 | invalid_api_key | 密钥缺失、格式错误、已撤销或无法识别。 |
| 403 | professional_required | 当前账户没有专业会员数据权限。 |
| 404 | metric_not_found | 指定指标不存在。 |
| 404 | table_not_found | 指定年鉴表格不存在。 |
| 429 | monthly_quota_exceeded | 本月 10,000 次调用额度已经用完。 |
| 503 | data_unavailable | 数据文件暂时无法读取，请稍后重试。 |
查看当前调用数量
匿名预览受每分钟频率限制但不消耗会员月度额度。专业会员每月可调用 10,000 次，每次通过参数校验与鉴权的完整数据调用都会返回：
x-rate-limit-monthly-used: 128
x-rate-limit-monthly-limit: 10000参数校验失败、无效密钥和权限不足不会消耗月度额度。达到上限后，接口返回 429，次月自动重新计算。
控制并发与重试
全站接口默认每分钟最多接受 120 次请求。遇到 429 或暂时性 503 时使用指数退避，不要无间隔循环重试。年鉴目录和指标定义适合在自己的服务中按数据版本缓存。