Configurar o acesso à API

Habilite sua loja (virtual) do PWA Kit para acessar de forma segura dados das Shopper APIs, como produtos, carrinhos, pedidos e mais. A tecnologia que autoriza esse acesso da API é chamada Shopper Login and API Access Service (SLAS), que é parte da Salesforce B2C Commerce API. Além de autorizar solicitações de API para a B2C Commerce API, o SLAS também autoriza solicitações de API para o Open Commerce API (OCAPI).

Recentemente, o processo de configuração foi simplificado graças à nova IU de administrador do SLAS.

Note

Antes de começar

Conclua as instruções em Autorização para Shopper APIs na documentação da B2C Commerce API para criar um cliente SLAS. Encorajamos você a usar um cliente privado SLAS, mas dependendo do seu caso de uso, você pode optar por usar um cliente público SLAS.

Se você planeja fazer uma implementação gradual de uma experiência do PWA Kit, siga as orientações na seção Etapas adicionais para implementações graduais do PWA Kit deste guia.

Depois de criar um cliente SLAS, retorne a este guia e continue lendo.

Definir o segredo do cliente

Se você estiver usando um cliente privado SLAS, deverá definir o segredo do cliente por meio de uma variável de ambiente.

Os projetos gerados a partir do PWA Kit 3.5 e superior serão configurados para usar um cliente privado SLAS por padrão.

Para saber mais sobre como usar clientes privados SLAS, consulte Usar um cliente privado SLAS.

Note

Se você estiver usando um cliente SLAS público, ignore esta seção e continue atualizando suas configurações de OCAPI conforme descrito na próxima seção.

Atualizar as configurações da Open Commerce API

Para certos recursos, a loja (virtual) do PWA Kit deve fazer solicitações ao Open Commerce API (OCAPI) na sua instância do B2C Commerce.

Veja aqui como atualizar as configurações de OCAPI para o PWA Kit:

Faça logon no Business Manager, em sua instância do B2C Commerce.
Acesse Administração > Desenvolvimento do site > Configurações do Open Commerce API.
Copie este JSON:

1{
2  "_v": "21.3",
3  "clients": [
4    {
5      "client_id": "PLACEHOLDER_CLIENT_ID",
6      "resources": [
7        {
8          "resource_id": "/sessions",
9          "methods": ["post"],
10          "read_attributes": "(**)",
11          "write_attributes": "(**)"
12        }
13      ]
14    }
15  ]
16}

Volte ao Business Manager e cole o JSON no campo.
Substitua o valor do espaço reservado para PLACEHOLDER_CLIENT_ID com o ID do cliente SLAS público que você criou usando a IU de administrador do SLAS.
Role até a parte inferior da página.
Clique em Salvar.

Repita essas instruções para cada instância do B2C Commerce que é usada com o PWA Kit.

Consulte também

Criar e personalizar