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

APIs de entrega delivery-apis

Last update: Tue Sep 09 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.

Quaisquer alterações feitas em ativos aprovados no DAM, incluindo atualizações de versão e modificações de metadados, são refletidas automaticamente nos URLs de entrega. Com um valor curto de Tempo de vida (TTL) de 10 minutos configurado para a entrega de ativos por meio da CDN, as atualizações se tornam visíveis em todas as interfaces de criação e publicação em menos de 10 minutos.

A imagem a seguir ilustra os URLs de entrega disponíveis:

APIs de entrega

A tabela a seguir ilustra o uso das várias APIs de entrega disponíveis:

API de entrega
Descrição
Representação binária otimizada para a Web do ativo no formato de saída solicitado
Retorna a representação binária otimizada para a Web do ativo no formato de saída solicitado com base na ID do ativo enviada na solicitação. Além disso, você pode definir vários modificadores de imagem, como largura, altura, rotação, inversão, qualidade, recorte, formato e recorte inteligente. Consulte os detalhes da API para obter os formatos e modificadores de imagem compatíveis.
A Adobe recomenda usar essa API para todos os tipos de formato de imagem.
Representação binária otimizada para a Web do ativo
A API de conveniência que aplica padrões a uma representação binária otimizada para a Web do ativo retornado na resposta. Os padrões incluem um formato JPEG/WEBP padrão, qualidade => 65 e largura => 1024.
Binário original carregado do ativo
Retorna os binários carregados originalmente para o ativo. A Adobe recomenda usar essa API para tipos de formato de documento e imagens SVG.
Representação pré-gerada do ativo disponível no ambiente de criação do AEM Assets
Retorna o fluxo de bits da representação de ativos disponível no ambiente de criação do AEM Assets com base na ID do ativo e no nome da representação enviados na solicitação.
Metadados do ativo
Retorna as propriedades associadas a um ativo, como, título, descrição, CreateDate, ModifyDate, entre outros.
Contêiner de player do ativo de vídeo
Retorna o container do reprodutor do ativo de vídeo. Você pode incorporar o reprodutor em um elemento HTML do iframe e reproduzir o vídeo.
Manifestos de reprodução no formato de saída selecionado
Retorna o arquivo de manifesto de reprodução do ativo de vídeo especificado no formato de saída selecionado. Você deve criar um reprodutor personalizado capaz de transmissão adaptável por meio dos protocolos HLS ou DASH para poder obter o arquivo de manifesto de reprodução e reproduzir o vídeo.
IMPORTANT
Você pode testar qualquer modificador, que geralmente não está disponível por meio de APIs experimentais. Por exemplo, </adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>
​>Clique aqui para saber mais sobre como usar as APIs experimentais e a lista completa de modificadores.

O Dynamic Media com recursos de OpenAPI também é compatível com vídeos de formulários longos. Os vídeos podem suportar até 50 GB e 2 horas.

Para obter informações sobre as ofertas do Dynamic Media disponíveis e seus recursos, consulte Dynamic Media Prime e Ultimate.

NOTE
Os clientes do DM Prime podem usar modificadores básicos de imagem, incluindo girar, cortar, virar, altura, largura e qualidade. A Imagem inteligente não é compatível com AVIF para clientes do DM Prime.

Endpoints das APIs de entrega delivery-apis-endpoint

Os endpoints da API variam para cada API de entrega. Por exemplo, o ponto de extremidade da API Web-optimized binary representation of the asset in the requested output format é:
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/{assetId}/as/{seoName}.{format}

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

Consulte detalhes da API para obter mais informações.

Método de solicitação de APIs de entrega delivery-api-request-method

GET

Cabeçalho das APIs de entrega deliver-assets-api-header

Você precisa fornecer os seguintes detalhes ao definir um cabeçalho no cabeçalho das APIs de entrega:

headers: {
      'If-None-Match': 'string',
      Authorization: 'Bearer <YOUR_JWT_HERE>'
    }

Para invocar as APIs de Entrega, é necessário um token IMS nos detalhes Authorization para entregar um ativo restrito. 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 da solicitação de APIs de Entrega.

Para exibir amostras de solicitações, amostras de respostas e códigos de resposta, consulte APIs de entrega.

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