在自定义操作中使用 API 调用响应

您可以在自定义操作中利用API调用响应，并根据这些响应编排历程。

重要说明

• 响应有效负载支持标量数组：

  "dummyScalarArray": [
  "val1",
  "val2"
  ]
  

• 响应有效负载中不支持异构阵列：

  "dummyRandomArray": [
  20,
  "aafw",
  false
  ]
  

配置自定义操作

1. 创建自定义操作。 请参见此页面。

2. 在 响应 字段。

   

3. 粘贴由调用返回的有效负载示例。 验证字段类型是否正确（字符串、整数等）。 以下是调用期间捕获的响应有效负载示例。 我们的本地端点发送会员积分数和用户档案的状态。

   {
   "customerID" : "xY12hye",
   "status":"gold",
   "points": 1290 }
   

   

   每次调用 API 时，系统将检索有效负载示例中包含的所有字段。

4. 我们还要将customerID添加为查询参数。

   

5. 单击​保存。

在历程中利用响应

只需将自定义操作添加到历程中。 然后，您可以在条件、其他操作和消息个性化中利用响应有效负载字段。

例如，您可以添加条件以检查会员积分数。 当人员进入餐厅时，您的本地端点会发送包含用户档案忠诚度信息的调用。 如果用户档案是黄金客户，则可以发送推送。 如果在调用中检测到错误，请发送自定义操作以通知您的系统管理员。

1. 添加您的事件和之前创建的忠诚度自定义操作。

2. 在“忠诚度”自定义操作中，将客户ID查询参数映射到配置文件ID。 选中选项 在超时或错误的情况下添加替代路径.

   

3. 在第一个分支中，添加一个条件并使用高级编辑器利用 上下文 节点。

   

4. 然后，添加推送，并使用响应字段个性化消息。 在本例中，我们使用忠诚度积分数和客户状态来个性化内容。 操作响应字段位于 上下文属性 > Journey Orchestration > 操作.

   

   注意

   每个输入自定义操作的配置文件都将触发调用。 即使响应始终相同，历程仍会为每个配置文件执行一个调用。

5. 在超时和错误分支中，添加条件并利用内置 jo_status_code 字段。 在我们的示例中，我们使用
   http_400 错误类型。 请参阅此章节。

   @action{ActionLoyalty.jo_status_code} == "http_400"
   

   

6. 添加将发送到贵组织的自定义操作。

   

测试模式日志

您可以通过测试模式访问与自定义操作响应相关的状态日志。 如果您在历程中定义了具有响应的自定义操作，则会看到 actionsHistory 部分，用于显示外部端点返回的有效负载（作为来自该自定义操作的响应）。 这在调试方面可能非常有用。

错误状态

此 jo_status_code 字段始终可用，即使未定义响应有效负载也是如此。

以下是此字段的可能值：

• http状态代码： http_<HTTP API call returned code>，例如http_200或http_400
• 超时错误： 超时
• 上限错误： 上限
• 内部错误： 内部错误

如果返回的http代码大于2xx或发生错误，则认为操作调用有误。 在这种情况下，历程会流向专用超时或错误分支。

表达式语法

以下是语法：

#@action{myAction.myField}

下面是一些示例：

 // action response field
 @action{<action name>.<path to the field>}
 @action{ActionLoyalty.status}

 // action response field
 @action{<action name>.<path to the field>, defaultValue: <default value expression>}
 @action{ActionLoyalty.points, defaultValue: 0}
 @action{ActionLoyalty.points, defaultValue: @{myEvent.newPoints}}

有关字段引用的更多信息，请参阅 本节.