끝점 검색
Reactor API의 /search
끝점은 쿼리로 표현되는 원하는 기준과 일치하는 리소스를 찾는 방법을 제공합니다.
다음 API 리소스 유형은 API에서 반환되는 리소스 기반 문서와 동일한 데이터 구조를 활용하여 검색할 수 있습니다.
audit_events
builds
callbacks
data_elements
environments
extension_packages
extensions
hosts
libraries
properties
rule_components
rules
모든 쿼리의 범위는 현재 회사 및 액세스 가능한 속성으로 지정됩니다.
- 메타는 검색할 수 없으며 검색 결과에 반환되지 않습니다.
- 확장 패키지 위임에 대한 스키마 필드(작업, 조건 등) 중첩된 데이터 구조가 아닌 텍스트로 검색할 수 있습니다.
- 범위 쿼리는 현재 정수만 지원합니다.
이 기능을 사용하는 방법에 대한 자세한 내용은 검색 가이드를 참조하세요.
시작하기
이 가이드에 사용된 끝점은 Reactor API의 일부입니다. 계속하기 전에 시작 안내서에서 API 인증 방법에 대한 중요한 정보를 검토하십시오.
검색 수행 perform
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
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
끝점 사용에 대한 추가 정보가 포함되어 있습니다.
값 연산자 논리 value-operator
검색 쿼리 값은 색인화된 문서와 일치하도록 용어로 분할됩니다. 각 용어 사이에 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
이(가) 높습니다. 부분 용어 일치의 특성으로 인해 원하는 값과 거의 일치하는 항목이 없을 때 텍스트 문자 몇 개와 같은 매우 기본적인 수준에서만 값이 일치하는 결과 세트를 얻을 수 있습니다.
일치하는 규칙 conventions
검색은 문서가 제공된 질의와 얼마나 관련이 있는지 답변하는 것과 관련이 있습니다. 문서 데이터가 분석되고 색인화되는 방식은 여기에 직접적인 영향을 미칩니다.
다음 표는 일반적인 필드 유형에 대한 일치 규칙을 분류합니다.
API에 표시되는 특정 필드에 대한 추가 규칙이 있습니다.
id
delegate_descriptor_id
::
에서 용어 분할이 있는 대/소문자를 구분하는 정확한 일치name
settings
type