Endpoint : Transferts

Créez des transferts de fichiers chiffrés, obtenez des URL de téléversement, puis listez, consultez ou supprimez vos transferts via l'API REST v1.

Le ressource Transferts vous permet de créer des envois de fichiers chiffrés, de récupérer des URL de téléversement, puis de lister, consulter ou supprimer vos transferts. Le flux se déroule en deux temps : vous appelez d'abord POST /v1/transfers en décrivant les fichiers (nom, taille, type MIME), puis vous téléversez chaque fichier directement via une requête PUT vers l'URL signée renvoyée. Les fichiers sont stockés dans l'Union européenne et chiffrés au repos en AES-256-GCM. Toutes les requêtes s'authentifient avec un en-tête Authorization: Bearer <clé> et la base de l'API est https://api.coffrify.com/v1.

Créer un transfert

POST/v1/transfersCrée un transfert et renvoie les URL de téléversement pour chaque fichier déclaré.

Le corps de la requête décrit les fichiers à envoyer ainsi que des options facultatives de partage. Le champ files est obligatoire : chaque entrée doit indiquer le name, la size (en octets) et le mime_type. Les autres champs ajustent la durée de vie, le nombre de téléchargements et la protection du lien.

Champ	Type	Description
files	tableau	Obligatoire. Liste des fichiers, chacun avec `name`, `size` (octets) et `mime_type`.
expires_in_hours	entier	Facultatif. Durée de validité du transfert, en heures, avant expiration automatique.
max_downloads	entier	Facultatif. Nombre maximal de téléchargements autorisés avant blocage du lien.
password	chaîne	Facultatif. Mot de passe exigé du destinataire pour accéder au transfert.
recipient	chaîne	Facultatif. Adresse e-mail du destinataire, utilisée pour la notification et le suivi.
transfer_title	chaîne	Facultatif. Titre lisible affiché sur la page de partage.

curl -X POST https://api.coffrify.com/v1/transfers \
  -H "Authorization: Bearer cof_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: tr-2026-06-10-001" \
  -d '{
    "files": [
      { "name": "contrat.pdf", "size": 482911, "mime_type": "application/pdf" }
    ],
    "expires_in_hours": 72,
    "max_downloads": 5,
    "recipient": "client@example.com",
    "transfer_title": "Contrat signe"
  }'

La réponse contient trois éléments : l'objet transfer (avec son id, son short_code, son status, son share_url et sa date expires_at), le tableau upload_urls (une entrée par fichier, avec file_id, url et headers à reproduire), et le share_url à transmettre au destinataire.

{
  "transfer": {
    "id": "trf_9aZ2kL",
    "short_code": "X7K2QP",
    "status": "awaiting_upload",
    "share_url": "https://coffrify.com/t/X7K2QP",
    "expires_at": "2026-06-13T09:00:00Z"
  },
  "upload_urls": [
    {
      "file_id": "file_3mNqR",
      "url": "https://uploads.coffrify.com/...",
      "headers": { "Content-Type": "application/pdf" }
    }
  ],
  "share_url": "https://coffrify.com/t/X7K2QP"
}

Téléverser les fichiers

Pour chaque entrée de upload_urls, envoyez le contenu binaire du fichier avec une requête PUT vers l'url fournie. Reproduisez exactement les en-têtes indiqués dans le champ headers de cette même entrée. Le transfert reste disponible une fois tous les fichiers téléversés.

curl -X PUT "https://uploads.coffrify.com/..." \
  -H "Content-Type: application/pdf" \
  --data-binary @contrat.pdf

Lister les transferts

GET/v1/transfersRenvoie la liste paginée des transferts de l'espace de travail.

La pagination s'effectue par curseur. Le paramètre limit accepte une valeur jusqu'à 100 (par défaut une valeur plus petite). Lorsque has_more vaut true, réutilisez la valeur de next_cursor dans le paramètre cursor pour récupérer la page suivante.

curl "https://api.coffrify.com/v1/transfers?limit=50" \
  -H "Authorization: Bearer cof_live_..."

Consulter un transfert

GET/v1/transfers/{id}Renvoie le détail d'un transfert à partir de son identifiant.

$ curl https://api.coffrify.com/v1/transfers/trf_9aZ2kL \
    -H "Authorization: Bearer cof_live_..."

Supprimer un transfert

DELETE/v1/transfers/{id}Supprime un transfert et rend son lien de partage immediatement inaccessible.

La suppression révoque l'accès au transfert et invalide son share_url. Cette opération exige le scope transfers:write. Un identifiant inconnu renvoie une erreur not_found.

$ curl -X DELETE https://api.coffrify.com/v1/transfers/trf_9aZ2kL \
    -H "Authorization: Bearer cof_live_..."