Reactor API의 관계

Reactor API의 리소스는 서로 관련되어 있습니다. 이 문서에서는 API에서 리소스 관계가 설정되는 방식과 각 리소스 유형의 관계 요구 사항에 대한 개요를 제공합니다.

해당 리소스의 유형에 따라 일부 관계가 필요합니다. 필수 관계는 상위 리소스가 관계 없이 존재할 수 없음을 의미합니다. 다른 모든 관계는 선택 사항입니다.

필수 또는 선택 사항인지에 관계없이, 관련 리소스를 만들 때 시스템에서 관계를 자동으로 설정하거나 수동으로 만들어야 합니다. 관계를 수동으로 만드는 경우, 해당 리소스에 따라 가능한 두 가지 방법이 있습니다.

• 페이로드별로 만들기
• URL로 만들기 (라이브러리용)

각 리소스 유형에 대한 호환 관계 목록 및 해당하는 경우 이러한 관계를 설정하는 데 필요한 방법은 관계 요구 사항의 섹션을 참조하십시오.

페이로드별 관계 만들기

처음 리소스를 만들 때 일부 관계를 수동으로 설정해야 합니다. 이를 수행하려면 먼저 상위 리소스를 만들 때 요청 페이로드에서 relationship 개체를 제공해야 합니다. 이러한 관계의 예는 다음과 같습니다.

• 필요한 확장을 사용하여 데이터 요소 만들기
• 필요한 호스트 관계를 사용하여 환경 만들기

API 형식

POST /properties/{PROPERTY_ID}/{RESOURCE_TYPE}

요청

다음 요청은 rules 및 extension와의 관계를 설정하는 새 rule_component을 만듭니다.

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",
        }
      }'

리소스별 관계 요구 사항

다음 표에서는 각 리소스 유형에 대해 사용 가능한 관계, 해당 관계가 필요한지 여부 및 해당하는 경우 관계를 수동으로 생성하는 허용 방법에 대해 설명합니다.

감사 이벤트

빌드

콜백

회사

데이터 요소

환경

확장

호스트

라이브러리

참고

속성

규칙 구성 요소

규칙