历程 API 入门

关于 API 上限和 API 限制

在配置数据源或操作时，您需要建立与系统的连接，以检索要在历程中使用的其他信息，或者发送消息或 API 调用。

历程 API 支持每秒最多 5000 个事件，但某些外部系统或 API 的吞吐量可能不同。为防止这些系统过载，您可以使用​ API 上限 ​和​ API 限制 ​来限制每秒发送的事件数量。

每次按历程执行 API 调用时，它都会通过 API 引擎。在达到 API 中设置的限制时，如果您使用的是“API 上限”，则会拒绝调用；或者，如果您使用的是“API 限制”，则会按收到的顺序将调用排入等待队列并尽快处理，可能需要 6 小时。

例如，假设您为外部系统定义了每秒100次调用的上限或限制规则。 在 10 个不同历程中，系统由自定义操作调用。如果一个历程每秒收到 200 个调用，则将使用 100 个可用的位置，并丢弃剩余的 100 个调用或将它们排入队列。由于超出了最大使用率，因此其他 9 个历程将没有任何位置。此粒度有助于避免使外部系统出现过载和崩溃。

有关如何使用这些 API 的更多信息，请参阅以下部分：

Swagger 文件中也对这两个 API 进行了说明，请点击此处了解详情。

数据源和自定义操作容量 capacity

对于​ 外部数据源，每秒的最大调用数限制为 15。如果超出此限制，则会根据所使用的 API，丢弃或排入任何其他调用。联系 Adobe 以将端点包含在允许列表中，这样可以增加专用外部数据源的此限制，但对于公共外部数据源不可以这样操作。* 了解如何配置数据源。

对于​ 自定义操作，您需要评估外部 API 的容量。例如，如果 Journey Optimizer 每秒发送 1000 个调用，而您的系统每秒只能支持 100 个调用，则需要定义上限或限制配置，以便系统不会饱和。了解如何配置操作

设置 API 访问 api

要在 Journey Orchestration 实例中使用这些 API，您需要使用 AdobeI/O 控制台。Journey Orchestration API 访问可通过以下步骤设置。有关每个步骤的详细信息，请参阅 Adobe I/O 文档。

要建立安全的服务到服务 Adobe I/O API 会话，对 Adobe 服务提出的每个请求都必须在“Authorization”标头中包含以下信息。

curl -X GET https://journey.adobe.io/authoring/XXX \
 -H 'Authorization: Bearer <ACCESS_TOKEN>' \
 -H 'x-api-key: <API_KEY>' \
 -H 'x-gw-ims-org-id: <ORGANIZATION>'