API REST

Endpoint : Transferts

Référence complète des endpoints CRUD des transferts.

POST /v1/transfers - Créer un transfert

POST/v1/transfersCrée un transfert et retourne les URLs d'upload présignées.

**Corps de la requête :**

{
  "files": [
    { "name": "rapport.pdf", "size": 1048576, "mime_type": "application/pdf" }
  ],
  "expires_in":    "7d",           // '1h'|'1d'|'7d'|'30d'|'90d' - requis
  "password":       "motdepasse",  // optionnel
  "max_downloads":  5,             // optionnel, null = illimité
  "notify_email":   "bob@acme.com" // optionnel, notifié à l'expiration
}

**Réponse 201 :**

{
  "id":           "tr_01JXXXXXXXXXXXXXXXX",
  "short_code":   "X9aB2c",
  "share_url":    "https://r.coffrify.com/X9aB2c",
  "status":       "pending_upload",
  "upload_urls":  ["https://s3.fr-par.scw.cloud/..."],
  "expires_at":   "2026-06-02T10:00:00Z",
  "created_at":   "2026-05-26T10:00:00Z"
}

POST /v1/transfers/:id/finalize - Activer

POST/v1/transfers/:id/finalizeMarque les uploads comme terminés. Le transfert passe en statut active.

Obligatoire après l'upload

Un transfert en statut `pending_upload` n'est pas accessible par les destinataires. Appelez `finalize` après avoir uploadé tous les fichiers.

GET /v1/transfers - Lister

GET/v1/transfersListe paginée des transferts du workspace.

GET /v1/transfers?limit=20&status=active&cursor=eyJpZCI6InRyXzAxSiJ9

GET /v1/transfers/:id - Détails

GET/v1/transfers/:idRetourne le transfert complet avec fichiers et statistiques de téléchargement.

DELETE /v1/transfers/:id - Supprimer

DELETE/v1/transfers/:idSupprime le transfert et efface les fichiers du stockage sous 60 secondes. Action irréversible.

Suppression permanente

La suppression est définitive. Les fichiers sont effacés du stockage Scaleway dans les 60 secondes. Les liens partagés retournent immédiatement 404.