用途:为 Grammarly API 版本变更提供升级与迁移指导,适用于在 API 版本之间迁移或更新端点引用时使用。
主要能力:资料提到 Grammarly 按 API 家族独立版本化(如 Writing Score 可能为 v2,AI Detection 仍为 v1),旧版本按固定时间线弃用,且不同版本的响应结构差异明显。技能提供版本检测思路(通过 HEAD 请求读取 x-grammarly-api-version、x-grammarly-deprecated 响应头)、迁移检查清单(审计 api.grammarly.com 端点引用、映射版本、校验子分数类别、置信度阈值、来源归属格式、OAuth scope、建议类别枚举、限流响应头、文本长度限制,并对样本语料做 v1/v2 对比)、旧版扁平分数到新版结构化 breakdown 的 schema 迁移示例,以及带 fallback 的回滚客户端示例。
使用方式:资料给出 TypeScript 代码示例,包括 detectGrammarlyVersions 函数、migrateScoreResponse 函数和 GrammarlyClient 类;基础地址为 https://api.grammarly.com/ecosystem/api。前置条件包括固定当前与目标版本、兼容性评估、沙箱夹具、破坏性契约负责人、版本化配置与 schema 备份、已批准的回退或禁用流程,以及合成文本和最小权限测试身份。流程为:盘点客户端、schema、配置、授权、遥测与文本保留变化;在沙箱升级并跑回归夹具;经批准后进入 staging 与金丝雀集成;监控回滚触发条件后分阶段推进或恢复固定旧版本;完成金丝雀与回滚演练后更新兼容性记录。输出为升级回执,含 from/to 版本、受影响契约、夹具与金丝雀结果、授权与保留结果、负责人批准、兼容性决定和回滚修订,且不含源文本与凭据。
限制:资料未提供具体价格、平台支持范围或实际效果数据;示例中的版本号与响应头字段为资料所载,实际以官方开发者门户与 API 变更日志为准。