跳转到内容
搜索文档

架构学习

最后更新 查看 MarkdownAgent 设置

架构学习通过观察实时 API 流量,自动发现端点接受的参数、标头和正文格式。对于保存到端点管理的所有端点,您可以按主机名以 OpenAPI v3.0.0 格式导出学到的架构。

要使用学到的架构保护您的 API,请参阅架构验证

导出架构

  1. 在 Cloudflare 仪表板中,前往 Web assets(Web 资产) 页面。

    Go to Web assets ↗
  2. 前往 Endpoints(端点) 选项卡。

  3. 选择 Export schema(导出架构) 并选择要导出的主机名。

  4. 选择是否包含学到的参数和速率限制建议。

  5. 选择 Export schema(导出架构) 并选择保存文件的位置。

  1. 登录到 Cloudflare 仪表板,然后选择您的账户和域。
  2. 选择 Security(安全性) > API Shield > Endpoint management(端点管理)
  3. 选择 Export schema(导出架构) 并选择要导出的主机名。
  4. 选择是否包含学到的参数速率限制建议
  5. 选择 Export schema(导出架构) 并选择保存文件的位置。

学到的架构将始终包含:

  • 服务器 (servers) 部分中列出的主机名
  • 按主机、方法和路径划分的所有端点

对于收到足够流量的端点,学到的架构还将包含:

  • 检测到的路径变量和格式
  • 检测到的查询参数和格式
  • 检测到的 POSTPUTPATCH 响应主体变量名称以及 application/json 内容类型的格式
  • 自动检测到的请求参数的格式

学到的架构可以可选地包含:

  • API Shield 的速率限制阈值建议

限制

在架构学习开始之前,端点必须至少添加 24 小时。架构学习是一个持续的过程,会检查端点最近 72 小时的流量。

架构学习仅从具有 2xx 响应代码的请求中学习。

架构学习在流量大时效果最好。对于过去 72 小时内请求数少于 10,000 的端点,您看到的学到的架构置信度可能会较低。

这篇文档对您有帮助吗?