Cabeçalhos HTTP personalizados custom-http-headers

Visão geral overview

Para obter mais controle sobre o back-end, os autores podem configurar cabeçalhos HTTP personalizados que seriam enviados ao mecanismo de comércio, juntamente com aqueles já enviados pelo CIF. Casos de uso comuns incluem configurações de várias lojas nas quais você pode usar cabeçalhos HTTP para controlar a resposta do back-end de comércio.

NOTE
Os desenvolvedores sempre podem configurar cabeçalhos HTTP personalizados usando a configuração do cliente GraphQL.

Configuração configuration

Para configurar os cabeçalhos HTTP personalizados, é necessário primeiro defini-los. Os cabeçalhos HTTP personalizados devem ser definidos primeiro adicionando-os à configuração do serviço com.adobe.cq.cif.http.internal.HttpHeadersConfigProviderImpl usando uma configuração OSGi.

Você pode configurar os valores dos cabeçalhos HTTP na página Configuração de Cloud Service do seu projeto:

  1. Acesse a página de configuração do Cloud Service em Ferramentas > Cloud Services > Configuração do CIF
  2. Abrir uma configuração existente ou criar uma
  3. Vá para a guia "Avançado" e localize o multicampo "Cabeçalhos HTTP personalizados". Você pode selecionar os cabeçalhos definidos anteriormente e atribuir valores a eles.

Os componentes que usam a configuração do Cloud Service acima enviarão esses cabeçalhos HTTP com cada solicitação do GraphQL.

Restrições restrictions

Embora o serviço permita a definição de qualquer nome de cabeçalho, incluindo os padrão, eles não estarão disponíveis para configuração. Em outras palavras, não é possível substituir os cabeçalhos HTTP padrão usando esse recurso. Uma lista de nomes de cabeçalho restritos pode ser encontrada em mdn web docs - HTTP headers. Além desses, há mais dois cabeçalhos que não podem ser usados:

  • "Loja" - usado pelo CIF para identificar a loja da Adobe Commerce
  • "Versão de visualização" - usado pelo CIF para recuperar produtos preparados
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab