Refresh de Token Publico
/auth/public
Gera um novo token publico, opcionalmente trocando o canal de venda para outro dominio da mesma loja
📋 Descricao
Este endpoint gera um novo token publico de autenticacao, permitindo opcionalmente trocar o canal de venda para outro dominio pertencente a mesma loja.
O principal caso de uso e a interoperabilidade entre temas que operam em dominios diferentes dentro da mesma loja. Ao informar um salesChannelDomain diferente do dominio atual, o token retornado carrega o contexto do novo canal de venda e marca internamente a flag domainRefreshed, permitindo que o middleware de validacao de host aceite requisicoes originadas de um dominio diferente do presente no token.
Comportamento do refresh:
- O token gerado sempre zera os campos
cartId,customerIdeuserId, iniciando uma sessao limpa no novo contexto. - O
storeIde validado entre os dois dominios — se o dominio solicitado pertencer a uma loja diferente, a requisicao e rejeitada com erro400. - Quando
salesChannelDomainnao e informado, o token e regenerado com o contexto do dominio atual.
📌 Parametros
Query Parameters
| Parametro | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
salesChannelDomain | string | Nao | Dominio do canal de venda de destino. Deve pertencer a mesma loja do dominio atual. Quando omitido, o token e regenerado com o contexto do dominio atual. |
Headers
| Header | Obrigatorio | Descricao |
|---|---|---|
Uappi-Cookie-Name | ⚠️ Condicional | Nome do cookie de sessao utilizado para identificar o token atual. |
💻 Exemplo de Requisicao
Refresh simples (mesmo dominio):
1curl --request GET \2 --url https://sua-loja-uappi.com.br/api/v3/auth/public \3 --header 'Uappi-Cookie-Name: token'Refresh com troca de dominio:
1curl --request GET \2 --url 'https://sua-loja-uappi.com.br/api/v3/auth/public?salesChannelDomain=checkout.minha-loja.com.br' \3 --header 'Uappi-Cookie-Name: token'✅ Resposta de Sucesso
1{2 "status": true,3 "data": {4 "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."5 }6}🔑 Campos do token decodificado
| Campo | Tipo | Descricao |
|---|---|---|
storeId | int | ID da loja (sempre o mesmo entre os dois dominios) |
tradePolicyId | int | ID da politica comercial do canal de venda solicitado |
currencyId | string | Moeda da politica comercial |
salesChannelId | int | ID do canal de venda solicitado |
salesChannelDomain | string | Dominio do canal de venda solicitado |
domainRefreshed | bool | true quando o dominio solicitado e diferente do dominio atual, false caso contrario |
cartId | string | Sempre vazio ("") — sessao limpa |
customerId | int | Sempre 0 — sessao limpa |
userId | int | Sempre 0 — sessao limpa |
❌ Erros
| Codigo | HTTP | Descricao |
|---|---|---|
INVALID_SALES_CHANNEL_DOMAIN | 400 | O dominio solicitado nao pertence a mesma loja do dominio atual. |