Guía de inicio

Esta guía te lleva desde cero hasta tener tu primer archivo subido y accesible desde la nube.

1. Crear una cuenta

Accede a fivehub.pro/register y regístrate con tu correo electrónico.

2. Crear una organización

Al iniciar sesión por primera vez verás el flujo de onboarding. Crea tu organización — es el espacio donde se almacenan tus assets y se gestionan los miembros y la facturación.

Puedes pertenecer a varias organizaciones. Los assets, API Keys y cuotas de almacenamiento son independientes por organización.

3. Generar una API Key

Ve al Dashboard → API Key.
Haz clic en Generar clave.
Copia la clave — no se mostrará de nuevo.

La clave está vinculada a tu organización activa. Inclúyela en todas tus peticiones con la cabecera x-api-key.

4. Subir tu primer asset

Con cURL

curl -X POST https://fivehub.pro/api/assets \
  -H "x-api-key: TU_API_KEY" \
  -F "file=@./mi-archivo.png" \
  -F "name=mi-logo"

Con el SDK de JavaScript

npm install fivehub.pro

import { FiveHubClient } from 'fivehub.pro';

const client = new FiveHubClient({ apiKey: 'TU_API_KEY' });

// Subir un archivo (Node.js)
import { readFileSync } from 'fs';
const buffer = readFileSync('./mi-archivo.png');
const blob = new Blob([buffer], { type: 'image/png' });

const asset = await client.upload(blob, 'mi-logo.png');
console.log('URL pública:', asset.publicUrl);

5. Acceder a tu asset

Cada asset tiene una publicUrl accesible directamente sin autenticación. Para archivos privados usa una URL firmada:

curl -H "x-api-key: TU_API_KEY" \
  "https://fivehub.pro/api/assets/ASSET_ID/url?expiresIn=3600"

La respuesta incluye una URL temporal válida por el tiempo especificado (en segundos).