应用流量申请规则

文档ID: 401313
页面标识: e759c2d7db83c850ec3146074a40da8d1616125375613
更新时间: 1709619002363
浏览量: 27592

---

1.流量规则介绍

快手电商开放平台从API稳定性考虑，将于2022年2月22日开启流量管控及流量预警通知，系统会根据应用近7日调用情况分配合适的日常流量初始值，保证您当前的日常调用不受影响。如广大开发者后续有更高的流量需求，请提查阅此规则了解流量管控开启后的详细内容，为流量管控开启做好准备。

流量管控开启后，应用状态在创建审核通过至上线之间时，应用调用每个API的QPS上限为100次/秒，所有API的日访问总量为10w次/天；应用状态为已上线时，应用调用每个API的QPS初始值为100次/秒，所有API的日访问总量初始值为100万次/天；如果已上线应用的初始流量无法满足您的需求，您可以在【应用管理-应用流量】中自主申请流量，当前应用流量消耗情况（QPS、日调用总量）可前往【监控中心-监控看板】查看，【监控中心-预警配置】可创建流量即将耗尽的预警提醒。

流量申请分为日常场景流量申请、重置当日流量和活动场景流量申请，三种类型的流量包不可同时申请，如有生效中的重置流量或活动流量需待其失效后方可申请新的流量。

各流量的适用场景和申请条件如下：

流量申请	适用场景	申请条件	流量有效期	审批时长
日常场景流量申请	应用近7日的流量值都维持在较高水平，申请日常场景流量以防限流	（申请流量）近7日有一天已使用流量>日常流量限额的80%且调用成功率>95% （申请QPS）近7日有一天的QPS峰值>日常QPS限额的90%且调用成功率>95%	长期有效	系统即时审核
重置当日流量	应用当日流量激增，但未达到日常流量申请门槛时，申请临时应急流量以恢复调用	当日已使用流量>限额的60%（满足条件当日最多可重置3次）	仅当日有效	系统即时审核
特殊场景流量申请	应用在未来一段时间内会有短时流量激增	平台或自身将在一段时间内举办活动	仅活动期间有效	人工定期审核

2.查看APP的日常流量

至“控制台-应用中心-应用管理-应用流量”中查看当前APP的日常访问流量值

3.设置流量预警

给应用设置流量预警，可在当天流量超过设置的阈值时收到邮件报警通知

4.申请提高流量

平台会根据APP最近7天的调用量以及调用成功率判断是否通过APP的提高流量申请，当调用成功率>90%且最近7天调用量>80%时会优先通过申请。请关注监控看板的调用成功率及天调用量，在需要提高流量时再进行流量申请。

日常场景流量是指应用长期需要使用的流量，包括日调用总量和QPS。

日调用总量梯度：应用上线前10万次/天，应用上线后100/500/1000/5000/10000/ 20000万次/天

QPS梯度：100/300/500/1000/3000/5000 次/秒

当您发现应用在近七天内有多天日调用总量大于等于当前梯度日调用总量上限的80%且长期会保持该调用量时，可以申请下一梯度日调用总量；应用在近七天内有多天某个API的QPS峰值大于等于当前梯度QPS上限的90%且长期会保持该QPS时，可以申请下一梯度QPS；如果两者都已经达到时，可以同时申请QPS和日调用总量提高；但是需保证API调用成功率大于等于95%。

注意：

1、如果日调用总量/QPS达到上限，即无下一梯度值时，将无法申请下一梯度日调用总量/QPS；如果该梯度值仍无法满足您的需求时，请提交工单进行说明，我们会酌情考虑是否提升QPS/日调用总量。

2、日调用总量/QPS不能跨梯度提升，如需跨梯度提升请提交工单进行说明，我们会酌情考虑是否跨梯度提升QPS/日调用总量。

5.紧急重置当日流量

当流量申请条件因调用成功率等情况无法满足时，为了避免线上业务受影响可以通过“重置”功能紧急重置当天的流量，当天流量将重新计算

重置当日流量是指应用当日流量突然激增，但近七天的流量值较低未满足日常场景流量申请条件时，为了避免当日调用失败，重置当日已使用的流量以快速恢复调用。

当您发现应用当天的日调用总量大于等于当前梯度日调用总量上限的60%，可以申请重置当日流量，仅当天生效。若您的APP流量的日常流量已>80%且调用成功率>95%，可按照第4点申请下一梯度的日常流量，将免审通过并永久生效。

注意：

1、重置流量仅当日有效，满足条件时一天最多可重置3次，每次重置获得的流量额度与日常流量额度相等（即最多重置3次，当日可获得3倍日常流量额度）。

1、如果同时满足日常流量申请条件和重置条件，将优先开放日常场景流量申请通道。

3、重置成功后，当日无法再次申请日常场景流量或活动场景流量，待次日重置流量失效后方可根据相应条件申请其他流量。

6.活动场景流量申请

活动场景流量是指平台举办活动或者您因自己原因，应用在未来一段时间内需要使用的流量。

您可以填写不大于100个期望提升的API（建议输入API名称快速匹配）及相应的QPS值和日调用总量值，自定义选择开始时间和结束时间。如果申请被审核通过，在生效期间内您指定的API将按照期望的QPS值控制流量，剩余API按照日常场景的QPS控制流量，日调用总量按照您期望值控制流量。当到达结束时间时，应用流量将回调至日常场景的流量值。

注意：

1、如果平台配置了活动

(1)留意公告/邮件中提到的申请截止时间，逾期无法提交活动场景流量申请，平台会按照应用的日常场景流量进行管控，直到活动结束后才可继续提交下一次活动场景流量申请。

(2)生效时间默认为平台活动时间，请根据自己需要进行调整。

2、如果一个活动场景流量提高申请审核通过且未结束时无法再提交下一个流量提高申请。

3、如果需要提前结束生效中或者待生效的活动流量请提交工单说明。

7.常见问题

7.1 Exceed quota limit报错

1、若报错为 Exceed quota limit, KEY [appkey:ks6887777777779839;primaryUserId:20009988843]格式，包含有appKey和userId维度的，请检查应用详情中的测试用户列表，添加到测试用户列表中的用户的调用量上限为2000次/天。若要对用户去除限制，请确保在测试用户列表中删除该用户，并且三方和快分销APP要到最终的上架状态，让用户进行订购完成授权状态；商家后台APP要到最终的上线状态，添加用户到授权用户列表后让用户对APP重新授权完成授权状态。

第三方开发者的应用和快分销应用需要为上架状态，即如下图所示展示服务信息。商家到服务详情页订购完成对应用的授权。

商家后台应用必须为上线状态，添加商家到授权用户列表，完成商家对应用的授权。

2、若报错为 Exceed quota limit, KEY [appkey:ks6887777777779839]格式，仅包含appKey维度的，则是appKey当天的调用流量已经超过平台分配的额度，可按照紧急程度按照上述第4点和第5点重置当天流量或申请长期生效的日常流量

8.总结

1、无论是日常场景流量申请、重置当日流量、还是活动场景流量申请，平台都会根据七天内API的QPS、日调用总量、调用成功率以及您的业务规模进行综合分析，若您的APP实际使用的流量远低于当前平台分配的流量额度，或您的APP近7天调用成功率远低于95%，则大概率将不予通过，感谢您的理解。

2、以上所述最终解释权归快手电商开放平台所有，如有其它疑问，请提交工单进行说明。