Assets API 검색 search-assets-api
Experience Manager 에셋 저장소에서 사용할 수 있는 모든 승인된 에셋을 검색한 다음 배달 URL을 사용하여 통합된 다운스트림 응용 프로그램으로 배달할 수 있습니다.
Experience Manager 저장소에서 올바른 승인된 에셋을 검색하는 것은 게재 URL을 사용하여 에셋을 게재하는 첫 번째 단계입니다. 검색 요청에 대한 응답은 검색 기준을 충족하는 에셋에 해당하는 JSON 문서 배열로 구성됩니다. 각 JSON 문서는 자산 배달 요청을 작성하는 데 사용되는 id 필드를 사용하여 식별됩니다.
Assets API 검색 요청 내에서 속성을 정의하여 다음 기능을 활성화할 수 있습니다.
-
전체 텍스트 검색:
match쿼리를 사용하여 검색할 텍스트를 정의합니다.match쿼리 내에서 연산자를 사용하여 결과를 필터링할 수도 있습니다. -
필터 적용:
term쿼리를 사용하여key및 하나 이상의 값을 정의하여 결과를 추가로 필터링합니다.key은(는) 값이 일치해야 하는 필드를 식별하며value은(는) 일치하는 항목을 나타냅니다. 마찬가지로range쿼리를 사용하여 다음보다 큼(gt), 다음보다 크거나 같음(gte), 다음보다 작음(lt) 및 다음보다 작거나 같음(lte) 속성을 사용하여 필드의 범위를 정의할 수 있습니다. -
결과 정렬:
OrderBy속성을 사용하여 하나 이상의 필드를 기준으로 검색 결과를 정렬합니다. 결과를 오름차순 또는 내림차순으로 정렬할 수 있습니다. -
페이지 매김:
limit및cursor속성을 사용하여 검색 API 요청 내에서 페이지 매김 속성을 정의합니다.limit속성은 API 응답에서 검색할 최대 항목을 정의합니다.cursor속성을 사용하면limit속성에 정의된 다음 자산 집합의 시작점을 쉽게 검색할 수 있습니다. 예를 들어 API 요청에서50을(를) 제한으로 정의하는 경우cursor속성을 사용하여 다음 API 요청을 사용하여 다음 50개 항목을 시작하고 검색할 수 있습니다.
자산 검색 API 엔드포인트 search-assets-api-endpoint
Search Assets API 요청의 끝점은 다음 형식이어야 합니다.https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/search
게재 도메인은 Experience Manager 작성자 환경의 도메인과 구조가 유사합니다. 유일한 차이점은 용어 author을(를) delivery(으)로 바꾸는 것입니다.
pXXXX은(는) 프로그램 ID를 참조합니다.
eYYYY이(가) 환경 ID를 참조합니다.
자산 검색 API 요청 메서드 search-assets-api-request-method
POST
Assets API 헤더 검색 search-assets-api-header
Search Assets API에서 헤더를 정의하는 동안 다음 세부 정보를 제공해야 합니다.
headers: {
'Content-Type': 'application/json',
'X-Adobe-Accept-Experimental': '1',
Authorization: 'Bearer <YOUR_JWT_HERE>',
'X-Api-Key': 'YOUR_API_KEY_HERE'
},
Search API를 호출하려면 Authorization 세부 정보에 IMS 토큰을 정의해야 합니다. IMS 토큰을 기술 계정에서 가져옵니다. 새 기술 계정을 만들려면 AEM as a Cloud Service 자격 증명 가져오기를 참조하십시오. IMS 토큰을 생성하고 자산 검색 API 요청 헤더에서 적절하게 사용하려면 액세스 토큰 생성을 참조하십시오.
요청 샘플, 응답 샘플 및 응답 코드를 보려면 Assets API 검색을 참조하십시오.