Pesquisar API do Assets search-assets-api
Todos os ativos aprovados disponíveis no repositório de ativos do Experience Manager podem ser pesquisados e entregues a aplicativos downstream integrados usando uma URL de entrega.
Pesquisar os ativos corretos aprovados no repositório Experience Manager é a primeira etapa para fornecer ativos usando o URL de entrega. A resposta à solicitação de pesquisa compreende uma variedade de documentos JSON correspondentes aos ativos que atendem aos critérios de pesquisa. Cada documento JSON é identificado usando um campo id, que é usado para compor a solicitação de entrega de ativos.
Você pode definir propriedades na solicitação da API Search Assets para ativar os seguintes recursos:
-
Pesquisa de texto completo: use a consulta
matchpara definir o texto a ser pesquisado. Você também pode usar operadores dentro da consultamatchpara filtrar os resultados. -
Aplicar filtros: use a consulta
termpara filtrar ainda mais os resultados definindo umkeye um ou vários valores.keyidentifica o campo cujo valor deve ser combinado evaluerepresenta o que deve ser comparado. Da mesma forma, você pode usar a consultarangepara definir um intervalo para um campo usando as propriedades Greater-than (gt), Greater-than ou equal-to (gte), Less-than (lt) e Less-than or equal-to (lte). -
Classificar resultados: use a propriedade
OrderBypara classificar resultados de pesquisa com base em um ou vários campos. Você pode classificar os resultados em uma ordem crescente ou decrescente. -
Paginação: use as propriedades
limitecursorpara definir propriedades de paginação em uma solicitação de API de Pesquisa. A propriedadelimitdefine o número máximo de itens a serem recuperados em uma resposta de API. A propriedadecursorfacilita a recuperação do ponto inicial para o próximo conjunto de ativos definido na propriedadelimit. Por exemplo, se você definir50como o limite na solicitação de API, poderá usar a propriedadecursorpara iniciar e recuperar os próximos 50 itens usando a próxima solicitação de API.
Pesquisar ponto de extremidade da API de ativos search-assets-api-endpoint
O endpoint em uma solicitação da API de ativos de Pesquisa deve estar no seguinte formato:https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/search
O domínio de delivery é semelhante em estrutura ao domínio do ambiente do autor do Experience Manager. A única diferença é a substituição do termo author por delivery.
pXXXX refere-se à ID do programa
eYYYY refere-se à ID de ambiente
Pesquisar método de solicitação da API de ativos search-assets-api-request-method
POST
Pesquisar cabeçalho da API do Assets search-assets-api-header
Você precisa fornecer os seguintes detalhes ao definir um cabeçalho na API de ativos de pesquisa:
headers: {
'Content-Type': 'application/json',
'X-Adobe-Accept-Experimental': '1',
Authorization: 'Bearer <YOUR_JWT_HERE>',
'X-Api-Key': 'YOUR_API_KEY_HERE'
},
Para invocar a API de Pesquisa, é necessário um token IMS para definir nos detalhes de Authorization. O token IMS é obtido de uma conta técnica. Consulte Buscar as credenciais do AEM as a Cloud Service para criar uma nova conta técnica. Consulte Gerar o token de acesso para gerar o token IMS e usá-lo corretamente no cabeçalho de solicitação da API de ativos de pesquisa.
Para exibir amostras de solicitações, amostras de respostas e códigos de resposta, consulte API de Assets de Pesquisa.