Documentacao da API XT3 Storage

Depois de criar sua conta, use a chave privada para subir arquivos e receber URL de acesso.

# Upload rapido
curl -X POST https://xt3.pro/api/upload.php \
  -H "X-API-Key: SUA_CHAVE_PRIVADA" \
  -F "file=@arquivo.pdf" \
  -F "public=1"

• Upload: use sua chave privada no header X-API-Key.
• Leitura privada: use chave publica para acessar arquivos privados.
• Arquivos publicos: nao exigem chave para download direto.

Envie o arquivo em multipart/form-data. Os campos public e folder sao opcionais.

# Upload completo
curl -X POST https://xt3.pro/api/upload.php \
  -H "X-API-Key: SUA_CHAVE_PRIVADA" \
  -F "file=@seu_arquivo.pdf" \
  -F "public=1" \
  -F "folder=contratos"

# Upload via PHP
$ch = curl_init('https://xt3.pro/api/upload.php');
$file = new CURLFile('seu_arquivo.pdf', 'application/pdf', 'seu_arquivo.pdf');

curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'X-API-Key: SUA_CHAVE_PRIVADA'
  ],
  CURLOPT_POSTFIELDS => [
    'file' => $file,
    'public' => '1',
    'folder' => 'contratos'
  ]
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

# Exemplo de resposta
{
  "success": true,
  "file": {
    "id": 123,
    "url": "https://xt3.pro/f/SEU_HASH_AQUI.pdf",
    "filename": "seu_arquivo.pdf",
    "size": 1048576,
    "is_public": true,
    "folder": {
      "name": "contratos",
      "hash": "ab12cd34ef56ab78"
    }
  }
}

# Sem autenticacao
https://xt3.pro/f/SEU_HASH_AQUI.pdf

# Com chave publica
curl https://xt3.pro/f/SEU_HASH_AQUI/ \
  -H "X-API-Key: SUA_CHAVE_PUBLICA"

Para retornar apenas informacoes do arquivo (sem baixar o conteudo), use ?info=1.

# Metadados do arquivo
curl https://xt3.pro/f/SEU_HASH_AQUI/?info=1 \
  -H "X-API-Key: SUA_CHAVE_PUBLICA"

O campo folder cria (ou reutiliza) uma pasta por usuario. O nome e normalizado e cada pasta possui hash unico internamente.

• Use nomes simples como clientes, financeiro e 2026.
• Pastas de contas diferentes nao conflitam, mesmo com o mesmo nome.
• A visibilidade do arquivo (public) e independente da pasta.