검색 끝점

다음 /search reactor API의 종단점은 쿼리로 표현되는 원하는 기준에 일치하는 리소스를 찾는 방법을 제공합니다.

다음 API 리소스 유형은 API에서 반환된 리소스 기반 문서와 동일한 데이터 구조를 사용하여 검색할 수 있습니다.

audit_events
builds
callbacks
data_elements
environments
extension_packages
extensions
hosts
libraries
properties
rule_components
rules

모든 쿼리는 현재 회사 및 액세스 가능한 속성으로 범위가 지정됩니다.

중요

검색 기능에는 다음과 같은 경고 및 예외가 있습니다.

meta는 검색할 수 없으며 검색 결과에 반환되지 않습니다.
확장 패키지 위임(작업, 조건 등)에 대한 스키마 필드 는 중첩된 데이터 구조가 아니라 텍스트로 검색할 수 있습니다.
범위 쿼리는 현재 정수만 지원합니다.

이 기능을 사용하는 방법에 대한 자세한 내용은 검색 안내서.

시작하기

이 안내서에 사용된 엔드포인트는 Reactor API. 계속하기 전에 시작 안내서 를 참조하십시오.

검색 수행

POST 요청을 만들어 검색을 수행할 수 있습니다.

API 형식

POST /search

요청

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "from": 0,
          "size": 25,
          "query": {
            "attributes.name": {
              "value": "Performance"
            },
            "attributes.revision_number": {
              "range": {
                "lte": "2",
                "gt": "0"
              }
            }
          },
          "sort": [
            {
              "attributes.revision_number": "desc"
            }
          ],
          "resource_types": [
            "data_elements",
            "rule_components"
          ]
        }
      }'

속성	설명
`from`	응답을 오프셋할 결과 수입니다.
`size`	반환할 최대 결과 양입니다. 결과는 100개 항목을 초과할 수 없습니다.
`query`	검색 쿼리를 나타내는 개체입니다. 이 개체의 각 속성에 대해 키는 쿼리할 필드 경로를 나타내야 하며 값은 하위 속성이 쿼리할 내용을 결정하는 개체여야 합니다. 각 필드 경로에 대해 다음 하위 속성을 사용할 수 있습니다. `exists`: 리소스에 필드가 있으면 true를 반환합니다. `value`: 필드의 값이 이 속성의 값과 일치하면 true를 반환합니다. `value_operator`: 를 결정하는 데 사용되는 부울 로직입니다 `value` 쿼리는 처리해야 합니다. 허용되는 값은 다음과 같습니다 `AND` 및 `OR`. 제외되면, `AND` 논리를 가정합니다. 의 섹션을 참조하십시오. 값 연산자 논리 추가 정보. `range` 필드의 값이 특정 숫자 범위 내에 있으면 true를 반환합니다. 범위 자체는 다음 하위 속성에 의해 결정됩니다. `gt`: 제공된 값보다 크고, 비포함. `gte`: 제공된 값보다 크거나 같음. `lt`: 제공된 값보다 작음, 비포함. `lte`: 제공된 값보다 작거나 같습니다.
`sort`	결과를 정렬할 순서를 나타내는 객체의 배열입니다. 각 객체에는 단일 속성이 포함되어야 합니다. 키는 정렬할 필드 경로를 나타내고 값은 정렬 순서(`asc` 오름차순 `desc` 내림차순).
`resource_types`	검색할 특정 리소스 유형을 나타내는 문자열 배열입니다.

응답

성공적인 응답은 쿼리에 일치하는 리소스 목록을 반환합니다. API에서 특정 값에 대한 일치 여부를 결정하는 방법에 대한 자세한 내용은 부록 섹션을 참조하십시오. 일치 규칙.

{
  "data": [
    {
      "id": "DE5d11b3ed301d4ce99b530a5121e392b2",
      "type": "data_elements",
      "attributes": {
        "created_at": "2020-12-14T17:36:09.045Z",
        "deleted_at": null,
        "dirty": true,
        "enabled": true,
        "name": "Performance Indicator",
        "published": false,
        "published_at": null,
        "revision_number": 1,
        "updated_at": "2020-12-14T17:36:09.045Z",
        "clean_text": false,
        "default_value": null,
        "delegate_descriptor_id": "kessel-test::dataElements::dom-attribute",
        "force_lower_case": false,
        "review_status": "unsubmitted",
        "storage_duration": null,
        "settings": "{\"elementProperty\":\"html\",\"elementSelector\":\".target-element\"}"
      },
      "relationships": {
        "libraries": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/libraries"
          }
        },
        "revisions": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/revisions"
          }
        },
        "notes": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/notes"
          }
        },
        "property": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/property"
          },
          "data": {
            "id": "PR97d92a379a5f48758947cdf44f607a0d",
            "type": "properties"
          }
        },
        "origin": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/origin"
          },
          "data": {
            "id": "DE5d11b3ed301d4ce99b530a5121e392b2",
            "type": "data_elements"
          }
        },
        "extension": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/extension"
          },
          "data": {
            "id": "EX0348d463358c4c89afe726245576f112",
            "type": "extensions"
          }
        },
        "updated_with_extension_package": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/updated_with_extension_package"
          },
          "data": {
            "id": "EP75db2452065b44e2b8a38ca883ce369a",
            "type": "extension_packages"
          }
        },
        "updated_with_extension": {
          "links": {
            "related": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2/updated_with_extension"
          },
          "data": {
            "id": "EX1cc78b39339242da82a0e0752fa53375",
            "type": "extensions"
          }
        }
      },
      "links": {
        "property": "https://reactor.adobe.io/properties/PR97d92a379a5f48758947cdf44f607a0d",
        "origin": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2",
        "self": "https://reactor.adobe.io/data_elements/DE5d11b3ed301d4ce99b530a5121e392b2",
        "extension": "https://reactor.adobe.io/extensions/EX0348d463358c4c89afe726245576f112"
      },
      "meta": {
        "latest_revision_number": 1
      }
    }
  ],
  "meta": {
    "total_hits": 1
  }
}

부록

다음 섹션에는 /search 엔드포인트.

값 연산자 논리

검색 쿼리 값은 인덱싱된 문서와 일치하도록 용어로 분할됩니다. 각 용어 사이에 AND 관계가 가정됩니다.

사용 시 AND 로서의 value_operator, 의 쿼리 값 My Rule Holiday Sale 는 을 포함하는 필드가 있는 문서로 해석됩니다 My AND Rule AND Holiday AND Sale.

사용 시 OR 로서의 value_operator, 의 쿼리 값 My Rule Holiday Sale 는 을 포함하는 필드가 있는 문서로 해석됩니다 My OR Rule OR Holiday OR Sale. 일치하는 용어가 많을수록 match_score. 부분 용어 일치의 특성으로 인해 원하는 값과 일치하는 항목이 없을 경우 텍스트 몇 문자와 같이, 매우 기본적인 수준에서만 값이 일치하는 결과 세트를 가져올 수 있습니다.

일치 규칙

제공된 질의와 관련된 문서의 내용에 대한 응답에 대해 검색을 수행합니다. 문서 데이터를 분석 및 인덱싱하는 방식은 이 요소에 직접 영향을 줍니다.

다음 표에서는 공통 필드 유형에 대한 일치 규칙을 분류합니다.

필드 유형	일치 규칙
문자열	부분 용어 분석, 대/소문자를 구분하지 않는 텍스트
열거형 값	정확히 일치, 대/소문자 구분
정수	정확히 일치
부유체	정확히 일치
타임스탬프	정확히 일치(DateTime 형식)
이름 표시	부분 용어 분석, 대/소문자를 구분하지 않는 텍스트

API에 표시되는 특정 필드에 대한 추가 규칙이 있습니다.

필드	일치 규칙
`id`	정확히 일치, 대/소문자 구분
`delegate_descriptor_id`	정확한 일치, 대/소문자 구분, 분할 사용 `::`
`name`	정확히 일치, 대/소문자 구분
`settings`	부분 용어 분석, 대/소문자를 구분하지 않는 텍스트
`type`	정확히 일치, 대/소문자 구분

새로운 검색, 검색 기능 개선

검색 끝점

시작하기

검색 수행

부록

값 연산자 논리

일치 규칙

Business.Adobe.com 리소스

이 페이지에서는

다음 보기:

학습

기술 문서

커뮤니티

고객지원

리소스

Adobe 계정

Adobe