API atual/Referência completa/Sessão do cliente

Sessões do cliente

Lista os aparelhos com sessão aberta e encerra uma sessão ou todas elas.

Cada login bem-sucedido cria uma sessão, ligada ao refresh_token entregue naquele login. A lista de sessões mostra onde o cliente está logado (aparelho, IP, quando entrou, quando expira). Encerrar uma sessão apaga o refresh_token dela: aquele aparelho não consegue mais renovar o acesso.

GET/api/v1/storefront/sessionsCliente

Listar sessões abertas

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/sessions" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Sessões

json

{
  "sessions": [
    {
      "id": "6d1d7b0e-5c8f-4b9a-8b0c-2f1a9a7e4c33",
      "user_id": "f12f30a9-cbec-40ba-98f1-b7fa8f2e8e10",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X)",
      "ip_address": "203.0.113.10",
      "expires_at": "2026-10-18T20:41:07Z",
      "created_at": "2026-10-11T20:41:07Z"
    }
  ],
  "total": 1
}

Campos da resposta

sessionsarray

Sessões ativas. Pode vir null quando não há nenhuma; trate null como lista vazia.

sessions[].iduuid

Id da sessão, usado para encerrá-la.

sessions[].user_iduuid

Dono da sessão.

sessions[].user_agentstring

Navegador ou app que fez o login, quando registrado. Pode faltar.

sessions[].ip_addressstring

IP do login, quando registrado. Pode faltar.

sessions[].expires_atstring

Quando a sessão deixa de poder renovar o acesso (RFC 3339, UTC).

sessions[].created_atstring

Quando a sessão foi aberta (RFC 3339, UTC).

totalinteger

Quantidade de sessões na lista.

DELETE/api/v1/storefront/sessions/{id}Cliente

Encerrar uma sessão

Parâmetros de caminho

iduuidobrigatório

sessions[].id da lista.

bash

curl -X DELETE "$BASE_URL/api/v1/storefront/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $TOKEN"

200Sessão encerrada

json

{
  "message": "session revoked"
}

DELETE/api/v1/storefront/sessionsCliente

Encerrar todas as sessões

Apaga todas as sessões do cliente, inclusive a que fez esta chamada. O access_token em uso continua valendo até expirar; no próximo renovo, o cliente precisa logar de novo.

bash

curl -X DELETE "$BASE_URL/api/v1/storefront/sessions" \
  -H "Authorization: Bearer $TOKEN"

200Todas encerradas

json

{
  "message": "all sessions revoked"
}

Erros

Status	Quando	Exemplo de corpo
400	Sessão inexistente ou de outro usuário. A mensagem vem do servidor em inglês e inclui os ids.	`{"error":"session 6d1d7b0e-... not found for user f12f30a9-..."}`
401	Sem token, ou token inválido.	`{"error":"missing authorization header"}`
429	Limite de requisições da família `/storefront/`.	`{"error":"rate limit exceeded","detail":"too many requests, please try again later"}`
500	Falha ao listar ou encerrar todas.	`{"error":"failed to list sessions","detail":"..."}`

Veja também

Sessões do cliente

Lista os aparelhos com sessão aberta e encerra uma sessão ou todas elas.

GET/api/v1/storefront/sessionsCliente

Listar sessões abertas

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/sessions" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Sessões

json

{
  "sessions": [
    {
      "id": "6d1d7b0e-5c8f-4b9a-8b0c-2f1a9a7e4c33",
      "user_id": "f12f30a9-cbec-40ba-98f1-b7fa8f2e8e10",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X)",
      "ip_address": "203.0.113.10",
      "expires_at": "2026-10-18T20:41:07Z",
      "created_at": "2026-10-11T20:41:07Z"
    }
  ],
  "total": 1
}

Campos da resposta

sessionsarray

Sessões ativas. Pode vir null quando não há nenhuma; trate null como lista vazia.

sessions[].iduuid

Id da sessão, usado para encerrá-la.

sessions[].user_iduuid

Dono da sessão.

sessions[].user_agentstring

Navegador ou app que fez o login, quando registrado. Pode faltar.

sessions[].ip_addressstring

IP do login, quando registrado. Pode faltar.

sessions[].expires_atstring

Quando a sessão deixa de poder renovar o acesso (RFC 3339, UTC).

sessions[].created_atstring

Quando a sessão foi aberta (RFC 3339, UTC).

totalinteger

Quantidade de sessões na lista.

DELETE/api/v1/storefront/sessions/{id}Cliente

Encerrar uma sessão

Parâmetros de caminho

iduuidobrigatório

sessions[].id da lista.

bash

curl -X DELETE "$BASE_URL/api/v1/storefront/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $TOKEN"

200Sessão encerrada

json

{
  "message": "session revoked"
}

DELETE/api/v1/storefront/sessionsCliente

Encerrar todas as sessões

Apaga todas as sessões do cliente, inclusive a que fez esta chamada. O access_token em uso continua valendo até expirar; no próximo renovo, o cliente precisa logar de novo.

bash

curl -X DELETE "$BASE_URL/api/v1/storefront/sessions" \
  -H "Authorization: Bearer $TOKEN"

200Todas encerradas

json

{
  "message": "all sessions revoked"
}

Erros

Status	Quando	Exemplo de corpo
400	Sessão inexistente ou de outro usuário. A mensagem vem do servidor em inglês e inclui os ids.	`{"error":"session 6d1d7b0e-... not found for user f12f30a9-..."}`
401	Sem token, ou token inválido.	`{"error":"missing authorization header"}`
429	Limite de requisições da família `/storefront/`.	`{"error":"rate limit exceeded","detail":"too many requests, please try again later"}`
500	Falha ao listar ou encerrar todas.	`{"error":"failed to list sessions","detail":"..."}`