官方公告：CDN 刷新预取接口调整通知。本次调整涉及 CDN 刷新预取相关接口，主要影响使用 API 进行缓存刷新和预取操作的开发者。调整后，原有接口的部分参数和行为将发生变化，请务必阅读本文以了解详情并完成迁移。
调整背景与目标
随着 CDN 服务的演进，我们持续优化缓存管理能力。本次接口调整旨在提升刷新和预取操作的效率与准确性，同时为未来功能扩展奠定基础。调整后，接口将更清晰地分离刷新与预取语义，并引入更细粒度的控制选项。
主要变更内容
以下是本次接口调整的核心变更点：
- 请求路径更新：刷新和预取接口的 URL 路径已更新，旧路径将在过渡期后停止服务。
- 参数调整：新增
scope参数用于指定操作范围（如全局或特定区域），同时废弃了原有的type参数。 - 响应格式变化：接口响应中新增了
request_id字段，便于追踪操作状态。 - 速率限制调整：对刷新和预取请求的频率限制进行了重新定义，请参考最新文档。
生效时间与过渡安排
新接口将于 2025 年 6 月 1 日正式生效，旧接口将保留至 2025 年 8 月 31 日。在此期间，两种接口均可使用，但我们强烈建议您尽快迁移至新接口，以避免后续服务中断。
迁移步骤
请按照以下步骤完成迁移：
- 查阅最新的 API 文档，了解新接口的请求格式和参数说明。
- 更新您的代码，将旧接口的调用替换为新接口。
- 在测试环境中验证功能，确保刷新和预取操作正常。
- 监控生产环境中的请求日志，确认没有错误。
兼容性与注意事项
在迁移过程中，请注意以下事项：
- 新接口不再支持部分旧参数，请检查您的请求中是否使用了已废弃的参数。
- 预取操作可能需要额外的权限配置，请确保您的 API 令牌具有相应权限。
- 对于大规模操作，建议分批执行，以避免触发速率限制。
常见问题解答
旧接口还能用多久？
旧接口将在 2025 年 8 月 31 日停止服务，请在此之前完成迁移。
迁移期间是否会影响现有服务？
过渡期内新旧接口并存，不会影响现有服务，但建议尽快迁移以享受新特性。
如何获取更多帮助？
您可以参考 Cloudflare 的官方文档（见文末参考资料），或联系技术支持。
参考资料
- Cloudflare 缓存官方文档：了解缓存工作原理与刷新机制。
- Cloudflare Workers 官方文档：了解如何利用 Workers 实现自动化缓存管理。
延伸阅读