Axuz Developers

GET /teams/{teamId}/files/{fileId}/versions/{v1}/diff/{v2}

Diff entre duas versões do arquivo

  • Acesso: Login
  • Serviço: https://files-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`.

v1/v2 são NÚMEROS de versão (1, 2, 3…), não UUIDs. Versão 1 de arquivo legado resolve pra mesma linha sintética de GET …/versions.

Duas formas de resposta, discriminadas pelo campo binary:

* binary: false — ambos os lados são textuais (MIME text/*, um punhado de MIMEs de código/dados, ou extensão conhecida) E cada versão tem ≤ 5 MiB. Traz o patch unified em text e o conteúdo íntegro dos dois lados em content_from/content_to. * binary: true — qualquer outro caso (inclusive arquivo textual grande demais). NÃO transfere bytes; devolve só tamanhos e mudança de MIME.

Fonte: internal/drive/handler_versions.go:94.

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
fileIdpathstringsim
v1pathintegersim

Número (não UUID) da versão de origem do diff.

v2pathintegersim

Número (não UUID) da versão de destino do diff.

Respostas

200

OK

NomeTipoObrigatórioDescrição
(corpo)oneOfnão

400

fileId inválido, ou v1/v2 não numéricos/≤ 0

NomeTipoObrigatórioDescrição
errorstringsim

Chave/slug do erro

messagestringnão

401

Sem credencial valida

NomeTipoObrigatórioDescrição
errorstringsim

404

Arquivo ou uma das versões não encontrada

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

502

Falha ao ler os bytes de uma das versões no storage

Exemplos

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

curl

curl -sS -X GET 'https://files-api.axuz.net/teams/TEAM_ID/files/FILE_ID/versions/V1/diff/V2' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

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