Axuz Developers

GET /share/{token}/preview

Preview inline (Content-Disposition inline)

  • Acesso: Pública (link ou assinatura)
  • Serviço: https://files-api.axuz.net

Autenticação aceita

Sem autenticação (rota pública ou protegida por link/assinatura).

— GET /share/{token}/preview?session=<jwt>. Content inline (browser embeda imagem/vídeo). Quando o link tem senha, a session é obrigatória; sem senha, qualquer chamada serve. Bumpa access_count.

Parâmetros

NomeEmTipoObrigatórioDescrição
tokenpathstringsim

Token opaco base64url (32 bytes ≈ 43 chars) ou UUID legacy.

sessionquerystringnão

Session token retornado por /share/{token}/verify (obrigatório se has_password=true).

Respostas

200

OK (bytes inline)

302

Presigned redirect

401

Session inválida ou ausente

410

Link revogado ou expirado

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://files-api.axuz.net/share/TOKEN/preview'

Node.js

const res = await fetch("https://files-api.axuz.net/share/TOKEN/preview", {
  method: 'GET',
});
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/share/TOKEN/preview",
    timeout=30,
)
res.raise_for_status()
print(res.json())