Axuz Developers

GET /auth/ws-token

Devolve o access JWT corrente pro client montar a conexão WebSocket com o axuz_api principal (browser WS API não permite custom cookies/h...

  • Acesso: Login
  • Serviço: https://auth-api.axuz.net

Autenticação aceita

  • sessionCookie — Sessão plena Axuz (cookie de sessão da casa). Sessão restrita é 403 enrollment_required.
  • bearerSession — JWT de acesso da sessão em `Authorization: Bearer`.

Devolve o access JWT corrente pro client montar a conexão WebSocket com o axuz_api principal (browser WS API não permite custom cookies/headers).

Motivo: WebSocket no browser não expõe API pra mandar Authorization header nem cookies cross-origin de forma confiável — os clients pegam o token via GET aqui e passam como query param ?token= no handshake WS (que o axuz_api valida com o mesmo JWT_SECRET). Comportamento: (1) lê cookie access_token; 401 se ausente/vazio; (2) valida via VerifyAccessToken; 401 se inválido; (3) responde 200 {token: <access>}.

Entradas: cookie access_token.

Retorno: 200 payload ou 401.

Parâmetros

Sem parâmetros.

Respostas

200

Payload ou 401

401

Sem credencial valida

NomeTipoObrigatórioDescrição
errorstringsim

429

Limite de requisições excedido.

NomeTipoObrigatórioDescrição
errorstringsim

500

Erro interno. Tente de novo com backoff; reporte o X-Request-Id.

NomeTipoObrigatórioDescrição
errorstringsim

Exemplos

O "Try it" está desligado nesta referência. Use os exemplos com a sua credencial de teste.

curl

curl -sS -X GET 'https://auth-api.axuz.net/auth/ws-token' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

const res = await fetch("https://auth-api.axuz.net/auth/ws-token", {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

Python

import os
import requests

res = requests.request(
    "GET",
    "https://auth-api.axuz.net/auth/ws-token",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())