一、总则
1.1 目的
本协议约定上海云飞网络科技工作室(以下称「我们」)向您提供的云飞API 核销接口服务的可用性水平、故障响应机制与补偿规则,是《云飞API 服务协议》的组成部分。
1.2 适用范围
本协议仅适用于生产环境的接口调用。测试环境、调试额度、沙箱接口、文档站点不在本协议保障范围内。
1.3 适用前提
本协议项下的承诺以下列条件为前提:
- 您按接口文档规范调用,未超出限流阈值;
- 您的网络环境与客户端实现正常;
- 您已完成必要的幂等与重试设计;
- 相关平台(美团、大众点评、抖音、快手)的开放接口处于正常状态。
不满足上述条件导致的调用失败,不计入不可用时长。
二、可用性定义与计算
2.1 可用性
可用性指在统计周期内,本服务正常响应有效请求的比例,按下式计算:
月度总时长按该自然月实际天数 × 24 小时计算。
2.2 有效请求
「有效请求」指符合下列全部条件的调用:
- 携带有效的应用密钥且通过鉴权;
- 请求参数格式与签名符合接口文档要求;
- 未超出约定的限流阈值;
- 请求的业务对象(券码、门店)真实存在。
2.3 不可用判定
「不可用」指在统计周期内,服务出现下列情形之一且持续 1 分钟以上:
- 网关无法建立连接,或持续返回 5xx 错误;
- 接口响应时间持续超过 5 秒(排除平台侧超时);
- 鉴权服务异常导致全部有效请求被拒绝;
- 核销请求在平台正常的情况下持续失败。
2.4 参考指标
| 指标 | 承诺值 | 说明 |
|---|---|---|
| 月度可用率 | ≥ 99.9% | 每月不可用时长不超过约 43 分钟 |
| 接口平均响应时间 | ≤ 200ms | 不含平台侧处理耗时,统计口径为网关接收请求至返回响应 |
| 故障响应时间 | 见第四条 | 自我们确认故障起算 |
| 数据持久性 | 99.99% | 仅指我们存储的调用日志,不含您自有系统的数据 |
三、不计入不可用的情形
下列情形导致的服务不可用,不计入不可用时长,也不构成违约:
3.1 平台侧原因
- 美团、大众点评、抖音、快手等平台开放接口故障、限流、变更或下线;
- 平台调整核销规则、改变鉴权方式、暂停应用权限;
- 平台进行系统维护、版本升级或灰度发布导致的接口不可用;
- 平台侧响应超时或返回非预期结果。
出现上述情形时,我们将尽合理努力通知您、提供临时方案或协助调整对接实现。
3.2 您侧原因
- 未按文档调用、参数错误、签名错误;
- 超出限流阈值被主动限制;
- 密钥泄露被冻结,或资质失效被停用;
- 您的服务器、网络、客户端环境异常;
- 未实现幂等导致重复调用被平台拒绝。
3.3 其他情形
- 不可抗力:自然灾害、战争、政府行为、大规模停电、基础电信运营商故障、国际出口中断;
- 大规模网络攻击(DDoS、CC 攻击等)且超出合理防护能力;
- 法律法规、监管要求导致的服务中止;
- 经您事先确认的例行维护(我们将提前 24 小时通知,并尽量安排在业务低峰时段);
- 您未在故障发生后 7 日内提出异议的时段。
四、故障响应与恢复
我们按影响范围对故障进行分级,并承诺相应的响应与恢复目标:
| 级别 | 判定标准 | 响应时限 | 恢复目标 |
|---|---|---|---|
| P1 严重 | 核心核销接口整体不可用,影响全部客户 | 15 分钟内 | 2 小时内 |
| P2 高 | 单一平台核销能力不可用,或错误率明显上升 | 30 分钟内 | 4 小时内 |
| P3 中 | 非核心接口(查询类)异常,或部分请求偶发失败 | 2 小时内 | 1 个工作日内 |
| P4 低 | 文档错误、单笔数据异常、咨询类问题 | 1 个工作日内 | 3 个工作日内 |
响应时限指自我们通过监控发现故障,或收到您有效报障(含明确的现象描述与请求样本)后,作出首次实质性回应的时间。
报障渠道
请通过 技术支持渠道 或邮箱 aoyanfei@yunfeiwork.com 报障,并附带:发生时间、接口名、请求参数(脱敏)、返回结果、您的应用标识。
五、监控与通知
- 我们对网关、鉴权、各平台通道实施持续可用性探测,探测频率不高于 1 分钟;
- P1、P2 级故障将在确认后通过企业微信或邮件通知受影响客户;
- 故障恢复后,我们将在 3 个工作日内提供事件说明(含原因、影响范围、处理过程与改进措施),P1 级故障必提供;
- 您也可在控制台查询接口调用成功率与错误分布,用于自行核对。
六、服务补偿
6.1 补偿标准
若某自然月可用率未达到 99.9%,且非因第三条排除情形所致,您可申请补偿。补偿以核销额度形式发放,不折现、不提现:
| 月度可用率 | 补偿额度(按当月实付费用的比例折算为核销次数) |
|---|---|
| 低于 99.9% 但不低于 99.0% | 10% |
| 低于 99.0% 但不低于 95.0% | 30% |
| 低于 95.0% | 100% |
6.2 申请流程
- 在故障发生月结束后 15 个自然日内提交书面申请;
- 附上故障时间、受影响请求样本、您的统计结果;
- 我们将在 5 个工作日内核对监控数据并答复;
- 核对一致的,补偿额度在 5 个工作日内充入您的账户。
6.3 补偿上限
单月补偿总额不超过您当月实际支付的服务费用。补偿是本协议项下未达服务等级的唯一救济方式,获得补偿后我们不再就该次故障承担其他赔偿责任。
6.4 不予补偿的情形
- 属于第三条排除情形导致的不可用;
- 您未在规定期限内提出申请;
- 您未按文档调用或超限流导致的失败;
- 测试额度、试用期内的调用。
七、其他
7.1 协议变更
我们可根据技术条件与服务能力调整本协议条款,变更前将通过官网公示,重大变更(如降低可用性承诺)提前 30 日通知。变更不溯及既往。
7.2 与其他文件的关系
本协议是《云飞API 服务协议》的组成部分。两者就同一事项约定不一致的,以本协议为准。
7.3 争议解决
因本协议产生的争议,适用中华人民共和国法律,由甲方所在地有管辖权的人民法院管辖。
7.4 联系我们
| 服务提供方 | 上海云飞网络科技工作室 |
|---|---|
| 技术支持 | doc.yunfeiapi.com |
| 邮箱 | aoyanfei@yunfeiwork.com |
| 电话 | 18201986514 |