SuperAPI AI 工具集

grammarly-migration-deep-dive

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:该技能聚焦 Grammarly API 迁移模式,适用于在 API 版本之间迁移,或从已弃用端点迁移到当前 REST API 的场景。资料指出,Grammarly Text Editor SDK 已于 2024 年 1 月弃用,当前 API 为 Writing Score(v2)、AI Detection(v1)和 Plagiarism Detection(v1)。

主要能力:对比弃用 SDK 与当前 API 的差异。弃用 SDK 为客户端执行、支持实时建议,但不提供写作评分、AI 检测和抄袭检测;当前 API 为服务端执行,不提供实时建议,但提供写作评分、AI 检测和抄袭检测。示例中服务端评分调用 https://api.grammarly.com/ecosystem/api/v2/scores,使用 Bearer 令牌和 JSON 请求体。

使用方式:迁移前需准备签署的迁移计划,明确数据负责人、同意/保留权限、目标允许列表以及切换/回滚负责人;清点不透明记录 ID 和聚合计数,而非导出文本、建议或用户数据;在沙箱中演练,并具备冻结提交、禁用新集成和恢复旧路径的能力。迁移时先建立聚合量、授权/同意、保留和合成行为的基线;在沙箱中进行有界幂等迁移演练,隔离模式、同意或目标不匹配;按队列逐个迁移,比较计数和政策探测,仅记录不透明关联 ID;在负责人批准和观察窗口后切换,保留旧路径直至满足恢复标准;出现政策、完整性、保留或行为失败时回滚,并在重试前记录失败边界。输出迁移回执,包含队列、基线/目标计数、同意/保留结果、检查点、负责人批准、切换状态和回滚引用,不得附带文本或凭据。

限制:遇到未知同意、目标、删除不完整、非幂等重放或保留漂移时应停止,保留脱敏回执并恢复先前受控路径,而非强行切换。资料未提供具体价格、平台支持范围或完整错误码列表。