DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Pesquisar API do Assets search-assets-api

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Usuário

Todos os ativos aprovados disponíveis no repositório de ativos da Experience Manager podem ser pesquisados e entregues a aplicativos downstream integrados usando uma URL de entrega.

Pesquisar os ativos corretos aprovados no repositório do 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.

Visão geral do protocolo de carregamento binário direto

Você pode definir propriedades na solicitação da API Search Assets para ativar os seguintes recursos:

  • Pesquisa de texto completo: use a consulta match para definir o texto a ser pesquisado. Você também pode usar operadores dentro da consulta match para filtrar os resultados.

  • Aplicar filtros: use a consulta term para filtrar ainda mais os resultados definindo um key e um ou vários valores. key identifica o campo cujo valor deve ser combinado e value representa o que deve ser comparado. Da mesma forma, você pode usar a consulta range para 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 OrderBy para 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 limit e cursor para definir propriedades de paginação em uma solicitação de API de Pesquisa. A propriedade limit define o número máximo de itens a serem recuperados em uma resposta de API. A propriedade cursor facilita a recuperação do ponto inicial para o próximo conjunto de ativos definido na propriedade limit. Por exemplo, se você definir 50 como o limite na solicitação de API, poderá usar a propriedade cursor para 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.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab