Reactor API中的关系

Reactor API中的资源通常相互关联。 本文档概述了如何在API中建立资源关系，以及每种资源类型的关系要求。

根据相关资源的类型，需要建立一些关系。 所需的关系意味着父资源不能没有关系而存在。 所有其他关系都是可选的。

无论关系是必需关系还是可选关系，系统都会在创建相关资源时自动建立关系，或者必须手动创建关系。 在手动创建关系的情况下，根据相关资源有两种可能的方法：

• 按有效负荷创建
• 按URL创建 （仅适用于库）

请参阅以下部分： 关系要求 以获取每个资源类型的兼容关系列表，以及在适用的情况下建立这些关系所需的方法。

按有效负荷创建关系

最初创建资源时，必须手动建立某些关系。 要完成此操作，您必须提供 relationship 请求有效负载中的对象。 这些关系的示例包括：

• 创建数据元素 具有所需的扩展
• 创建环境 具有所需的主机关系

API格式

POST /properties/{PROPERTY_ID}/{RESOURCE_TYPE}

请求

以下请求创建一个新的 rule_component，建立关系 rules 和 extension.

curl -X POST \
  https://reactor.adobe.io/properties/PRf606dbddfbdc44f580fc6f342b5ff9be/rule_components \
  -H 'Authorization: Bearer [TOKEN]' \
  -H 'x-api-key: [KEY]' \
  -H 'x-gw-ims-org-id: [ORG_ID]' \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -H 'Content-Type: application/vnd.api+json' \
  -d '{
        "data": {
          "attributes": {
            "delegate_descriptor_id": "kessel-test::events::click",
            "name": "My Example Click Event",
            "settings": "{\"elementSelector\":\".accordion\",\"bubbleFireIfChildFired\":true}"
          },
          "relationships": {
            "extension": {
              "data": {
                "id": "EXa2865f4d14204fa094f247406424371b",
                "type": "extensions"
              }
            },
            "rules": {
              "data": [
                {
                  "id": "RLd53598e3f1884e63bbc8e9c95e463dcf",
                  "type": "rules"
                }
              ]
            }
          },
          "type": "rule_components"
        }
      }'

通过URL创建关系

与其他资源不同，图书馆通过自己的专属资源建立关系 /relationship 端点。 示例包括：

• 将扩展、数据元素和规则添加到库
• 将库分配给环境

API格式

POST /properties/{PROPERTY_ID}/libraries/{LIBRARY_ID}/relationships/{RESOURCE_TYPE}

请求

以下请求使用 /relationships/environment 用于创建与环境关系的库的端点。

curl -X POST \
  https://reactor.adobe.io/properties/PRf606dbddfbdc44f580fc6f342b5ff9be/libraries/LB10c1fd171cd347f19fcb8659a8d679ef/relationships/environment \
  -H 'Authorization: Bearer [TOKEN]' \
  -H 'x-api-key: [KEY]' \
  -H 'x-gw-ims-org-id: [ORG_ID]' \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -H 'Content-Type: application/vnd.api+json' \
  -d '{
        "data": {
          "id": "ENf395a477d2b24ad696d65b901055b9dc",
          "type": "environments",
        }
      }'

按资源列出的关系要求

下表概述了每种资源类型的可用关系（无论这些关系是否必需），以及在适用的情况下手动创建关系的接受方法。

审核事件

内部版本

回调

公司

数据元素

环境

扩展

托管

库

注释

属性

规则组件

规则

密钥

Business.Adobe.com 资源