尊敬的萤石开放平台用户: 感谢您长期以来对萤石开放平台的信任与支持。为了更好的为客户提供接口服务,今天正式上线开放平台配额中心。 一、产品介绍 配额中心是集中管理开放平台接口调用配额的服务。 通过配额中心,您可以查询接口的配额限制,并根据业务需要申请提升接口配额。 配额中心以「用户 + 接口(URL)」为维度,对开放平台接口的调用频率与调用量进行统一的用量统计、配额管理和限流治理,保障开放平台整体服务的稳定性与公平性。 功能特性 基于您的应用场景,配额中心提供的功能特性如下表所示。
|
场景
|
功能
|
|
查询配额
|
控制台提供当日各接口的调用频率及配额上限查询,帮助您掌握用量情况。
|
|
查询配额是否可调整
|
选择接口后,可查询该接口的配额项及是否支持在线申请调整。
|
|
申请提升配额
|
对于可调整的接口配额,您可以通过控制台提交配额提升申请,由平台侧审核变更。
|
|
查询申请历史
|
您可以查询自己提交的配额提升申请及其审核状态。
|
|
创建配额告警
|
您可以为配额项设置告警规则,在用量达到阈值(如 80%)时接收短信告警,提前申请提升配额。
|
基本概念
|
概念
|
说明
|
|
配额
|
一个账号在单位时间内可调用某接口的最大频率(QPS),基于「用户 + 接口」维度。
|
|
可调整配额
|
可通过控制台申请调整的配额。已有申请在流程中时,不可再发起新流程。
|
|
默认配额值
|
平台为每个账号/接口设置的配额初始值为30,特殊接口限制会在接口文档中说明。
|
|
已使用配额值
|
当日该接口的实际调用量或调用频率峰值。
|
|
配额申请值
|
申请的期望配额值,审批通过后覆盖原配额值。
|
|
API 速率配额
|
对接口调用频率(QPS)的约束限制,可随业务发展逐步申请扩大。
|
|
配额告警
|
用量达到配额设定百分比阈值时触发的提醒通知。
|
二、限制内容
|
项目
|
说明
|
|
统计维度
|
按「用户
+ 接口 URL」统计,频率峰值
|
|
配额对象
|
接口调用频率(QPS)
|
|
超限处理
|
超过配额后,被限流的请求将被拦截
|
|
告警阈值
|
调用量达到配额的设定百分比(如 80%)时触发短信告警
|
|
限流范围
|
开放接口
|
三、控制台使用方法开发者可通过开放平台控制台自助查看用量并管理配额:
- 登录控制台,进入「账号中心 / 通用配额」页面。
- 查看当日调用情况:在通用配额列表中查看当前账号各接口的调用频率及对应配额,判断是否接近或超过上限。
- 申请调整配额:对需要更高配额的接口,提交「配额调整申请」,填写业务场景、预估 QPS 等信息,提交后由平台侧审核变更。
- 配置告警通知:开启配额百分比告警,当调用量达到设定阈值(如 80%)时,会收到短信通知,便于提前申请提额或优化调用。
- 持续跟踪:上线初期建议关注告警通知与调用量趋势,避免因突发流量触发限流影响业务。
如需了解更多技术细节或获取集成支持,请联系萤石技术支持团队:
|