使用 API 限制

最近更新： 2025年4月14日

创建对象：

  • 初学者
  • 用户

节流API可帮助您创建、配置和监视节流配置，以限制每秒发送的事件数。

本节提供有关如何使用API的全球信息。 Adobe Journey Optimizer API文档中提供了详细的API描述。

必读

  • 每个组织一个配置： ​当前每个组织只允许一个配置。 必须在生产沙盒上定义配置（通过标头中的x-sandbox-name提供）。

  • 组织级别的应用程序： ​在组织级别应用了配置。

  • API限制处理： ​当达到API中设置的限制时，其他事件将排队等候最多6小时。 无法修改此值。

  • maxHttpConnections参数：“maxHttpConnections”参数是可选参数，在Capping API中可用，仅允许您限制Journey Optimizer将打开到外部系统的连接数。 了解如何使用上限API

    如果要限制连接数，但同时限制这些外部调用，则可以在同一端点上配置两个配置，一个限制和一个限制。 两个配置可以针对一个端点共存。 要为节流端点设置“maxHttpConnections”，请使用节流API设置节流阈值，并使用上限API设置“maxHttpConnections”。 在调用上限API时，您可以将上限阈值设置为高于限制阈值的值，以便该上限规则实际上永远不会起作用。

限制API描述和Postman收藏集

下表列出了用于限制API的可用命令。 Adobe Journey Optimizer API文档中提供了请求示例、参数和响应格式的详细信息。

方法路径描述
POSTlist/throttlingConfigs获取限制配置列表
POST/throttlingConfigs创建限制配置
POST/throttlingConfigs/{uid}/deploy部署限制配置
POST/throttlingConfigs/{uid}/undeploy取消部署限制配置
POST/throttlingConfigs/{uid}/canDeploy检查是否可以部署限制配置
PUT/throttlingConfigs/{uid}更新限制配置
GET/throttlingConfigs/{uid}检索限制配置
DELETE/throttlingConfigs/{uid}删除限制配置

此外，此处还提供了一个Postman收藏集，帮助您进行测试配置。

此集合已设置为共享通过​ Postman控制台的集成 >尝试使用>下载Adobe I/O生成的Postman变量集合，这将生成一个具有选定集成值的Postman环境文件。

下载并上传到 Postman 后，您需要添加三个变量：{JO_HOST}、{BASE_PATH} 和 {SANDBOX_NAME}。

  • {JO_HOST} ： Journey Optimizer网关URL。
  • {BASE_PATH} ： API的入口点。
  • {SANDBOX_NAME}：标头 x-sandbox-name（例如，“prod”），对应将执行 API 操作的沙盒名称。有关更多信息，请参阅沙盒概述。