Cabeçalhos HTTP personalizados

Última atualização em 2023-11-07

Visão geral

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.

OBSERVAÇÃO

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

Configuração

Para configurar os cabeçalhos HTTP personalizados, é necessário primeiro defini-los. Os cabeçalhos HTTP personalizados devem ser definidos primeiro adicionando-os à com.adobe.cq.cif.http.internal.HttpHeadersConfigProviderImpl configuração do serviço 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. Vá para a página de configuração do Cloud Service em Ferramentas > Cloud Services > Configuração do CIF.
  2. Abra uma configuração existente ou crie 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 enviam esses cabeçalhos HTTP com cada solicitação do GraphQL.

Restrições

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 aqui. 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

Nesta página