Skip to content

Refresh de Token Publico

GET /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, customerId e userId, iniciando uma sessao limpa no novo contexto.
  • O storeId e validado entre os dois dominios — se o dominio solicitado pertencer a uma loja diferente, a requisicao e rejeitada com erro 400.
  • Quando salesChannelDomain nao e informado, o token e regenerado com o contexto do dominio atual.

📌 Parametros

Query Parameters

ParametroTipoObrigatorioDescricao
salesChannelDomainstringNaoDominio 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

HeaderObrigatorioDescricao
Uappi-Cookie-Name⚠️ CondicionalNome 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

CampoTipoDescricao
storeIdintID da loja (sempre o mesmo entre os dois dominios)
tradePolicyIdintID da politica comercial do canal de venda solicitado
currencyIdstringMoeda da politica comercial
salesChannelIdintID do canal de venda solicitado
salesChannelDomainstringDominio do canal de venda solicitado
domainRefreshedbooltrue quando o dominio solicitado e diferente do dominio atual, false caso contrario
cartIdstringSempre vazio ("") — sessao limpa
customerIdintSempre 0 — sessao limpa
userIdintSempre 0 — sessao limpa

❌ Erros

CodigoHTTPDescricao
INVALID_SALES_CHANNEL_DOMAIN400O dominio solicitado nao pertence a mesma loja do dominio atual.

Uappi é a melhor opção para o crescimento da sua loja!

;