Axuz Developers

GET /teams/{teamId}/flowcharts/{id}/versions/{versionId}

Devolve o documento completo de uma versão, pro diff visual do cliente.

  • Acesso: Membro da equipe
  • Serviço: https://api-flow.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 documento completo de uma versão, pro diff visual do cliente. Onde: montado em RegisterTeamRoutes (handlers_routes.go); consumido por components/flow/versions/versionDocument.ts no axuz_flow_client.

getVersionDocument — GET /teams/{teamId}/flowcharts/{id}/versions/{versionId}.

Entradas: path params id (flowchart) e versionId, ambos uuid.

Retorno: 200 com versionDocumentResponse; 400 em uuid malformado; 404 quando o flowchart não é do team OU a versão não é do flowchart; 500 em erro de banco (nunca 404 disfarçando falha — o cliente leria como "essa versão não existe").

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
idpathstringsim
versionIdpathstringsim

Respostas

200

Com versionDocumentResponse

400

Em uuid malformado

NomeTipoObrigatórioDescrição
errorstringsim

401

Sem credencial valida

NomeTipoObrigatórioDescrição
errorstringsim

403

Sem permissao (nao e owner/admin; token sem escopo; token de integracao em rota nao permitida)

NomeTipoObrigatórioDescrição
errorstringsim

404

Quando o flowchart não é do team OU a versão não é do flowchart

NomeTipoObrigatórioDescrição
errorstringsim

429

Limite de requisições excedido.

NomeTipoObrigatórioDescrição
errorstringsim

500

Em erro de banco (nunca 404 disfarçando falha — o cliente leria como "essa versão não existe")

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://api-flow.axuz.net/teams/TEAM_ID/flowcharts/ID/versions/VERSION_ID' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

const res = await fetch("https://api-flow.axuz.net/teams/TEAM_ID/flowcharts/ID/versions/VERSION_ID", {
  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://api-flow.axuz.net/teams/TEAM_ID/flowcharts/ID/versions/VERSION_ID",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())