Axuz Developers

GET /share/{token}/preview

Preview inline (Content-Disposition inline)

  • Access: Public (link or signature)
  • Service: https://files-api.axuz.net

Accepted authentication

No authentication (public route, or protected by link/signature).

— 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.

Parameters

NameInTypeRequiredDescription
tokenpathstringyes

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

sessionquerystringno

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

Responses

200

OK (bytes inline)

302

Presigned redirect

401

Session inválida ou ausente

410

Link revogado ou expirado

429

Limite de requisições excedido.

NameTypeRequiredDescription
errorstringyes

500

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

NameTypeRequiredDescription
errorstringyes

Examples

"Try it" is turned off in this reference. Use the examples with your test credential.

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())