Developer Experience

Reference API pensata per integrare in pochi minuti.

Swagger interattivo, auth immediata, quickstart concreto e ricerca full-text. Un developer deve capire come usare upload, bucket e signed URL senza perdere mezz’ora a orientarsi.

DisponibilitàVerifica

Operazioni ricercabili0

FormatiUI · JSON · Agent

Quickstart

Integra file-hub in tre step.

Prendi una API key dal account WebUI, crea un bucket, carica un file e poi genera un signed URL. Tutto dal browser o via cURL.

Base URL/api/v1

AuthBearer fhk_***

Uploadmultipart/form-data

Prima cosa: genera una API key.

La documentazione è pubblica, ma le chiamate API reali richiedono Authorization: Bearer fhk_... creata dal account WebUI.

01POST /api/v1/buckets

Crea un bucket

Definisci uno spazio logico con visibilità di default, MIME types consentiti e limiti di dimensione.

curl -X POST https://your-domain/api/v1/buckets \
  -H "Authorization: Bearer fhk_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "avatars",
    "slug": "avatars",
    "defaultVisibility": "PRIVATE"
  }'

02POST /api/v1/upload

Carica un file

Usa multipart/form-data per inviare file, tags, metadata e contesto applicativo in una singola richiesta.

curl -X POST https://your-domain/api/v1/upload \
  -H "Authorization: Bearer fhk_<your_key>" \
  -F "file=@avatar.png" \
  -F "bucketSlug=avatars" \
  -F "visibility=PRIVATE"

03POST /api/v1/signed-url

Genera un signed URL

Esponi un file privato per pochi minuti senza mai mandare la API key al browser.

curl -X POST https://your-domain/api/v1/signed-url \
  -H "Authorization: Bearer fhk_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "<file_id>",
    "expiresInSeconds": 900
  }'

Reference

Testa ogni endpoint direttamente nel browser.

Swagger resta il centro della pagina: autorizza, prova le richieste, ispeziona response e modelli senza uscire dalla reference.

Caricamento reference API

Sto montando Swagger UI dal bundle locale del progetto.