用途:为 Grammarly 写作 API 集成故障提供事件响应流程,覆盖文本检查超时、建议质量下降、OAuth 令牌失败与限流风暴。因该 API 支撑实时写作辅助,故障会直接影响文本检查、评分流程与内容质量管线。
主要能力:按严重级别分类——P1 完全中断(15 分钟响应)、P2 认证失败或持续超时(30 分钟)、P3 限流或延迟升高(2 小时)、P4 建议质量漂移或单端点问题(8 小时)。提供诊断命令,包括免认证健康检查、带认证的评分请求和 OAuth 令牌有效性检查;提供 API 中断、认证失败、数据同步失败三类处置剧本,以及沟通模板、事后复盘项和错误处理对照表。
使用方式:打开带时间戳的事件记录并分类影响,用合成输入复现一次;仅用状态码与关联 ID 隔离边界(身份、端点、配额、客户端集成或下游存储);冻结非必要变更,执行一次可回滚处置并监控合成探测与聚合指标;验证恢复后以脱敏证据关闭事件。建议监控限流在 80% 阈值告警、令牌到期前提前 10 分钟刷新。
限制:前提包括事件负责人、支持路径、不含客户或员工文本的合成健康输入、只读诊断与已知基线,以及禁止外传源文本、建议、请求头或令牌的脱敏规范。输出的事件回执不得包含提交文本、建议、身份或凭证。