Créer un transfert avec options avancées (expiration, mot de passe, approbation)

La route POST /v1/transfers crée un transfert et retourne les URL d'upload pré-signées pour chaque fichier. Une fois les fichiers déposés sur ces URL, le transfert devient actif et le lien de partage est utilisable. Les options avancées, expiration sur mesure, mot de passe, nombre de téléchargements maximum et circuit d'approbation, se configurent dès la création ou se mettent à jour via des routes dédiées.

Authentification

Toutes les routes ci-dessus requièrent une clé API transmise dans l'en-tête Authorization: Bearer <clé>. Utilisez une clé de test (cof_test_…) pour vos intégrations hors-production ou une clé sandbox (cof_sandbox_…) pour les simulations complètes. En production, utilisez une clé live (cof_live_…). Le scope requis varie selon la route : transfers:write pour créer, modifier le mot de passe ou prolonger ; transfers:manage pour gérer les approbateurs et rendre des décisions d'approbation.

Corps de la requête, POST /v1/transfers

Le corps accepte de nombreuses options avancées (mot de passe, expiration, TOTP, approbation, restrictions). Seul files est obligatoire. Le tableau ci-dessous détaille les champs.

Exemples d'appel

L'exemple ci-dessous crée un transfert avec plusieurs options de sécurité activées. Choisissez votre langage.

curl -X POST https://api.coffrify.com/v1/transfers \
  -H "Authorization: Bearer cof_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "transfer_title": "Rapport annuel 2025",
    "files": [
      { "name": "rapport-2025.pdf", "size": 2048000, "mime_type": "application/pdf" }
    ],
    "expires_in_hours": 72,
    "password": "S3cr3t!",
    "max_downloads": 10,
    "notify_opens": true,
    "recipient": "client@example.com"
  }'

Réponse

{
  "transfer": {
    "id": "trf_01J9ZX4KPQM7WVBN3DGEH52RAT",
    "short_code": "aB3kZ9",
    "transfer_title": "Rapport annuel 2025",
    "status": "pending_upload",
    "expires_at": "2025-09-09T14:32:00.000Z",
    "max_downloads": 10,
    "total_downloads": 0,
    "scan_status": "pending",
    "encryption_mode": null,
    "created_at": "2025-09-06T14:32:00.000Z"
  },
  "upload_urls": [
    {
      "file_id": "rapport-2025.pdf",
      "url": "https://storage.coffrify.com/uploads/trf_01J9ZX4KPQM7WVBN3DGEH52RAT/rapport-2025.pdf?X-Amz-Expires=900&...",
      "headers": {
        "Content-Type": "application/pdf"
      }
    }
  ],
  "share_url": "https://files.coffrify.com/aB3kZ9",
  "totp_secret": null
}

Le champ totp_secret est non-null uniquement si require_totp: true a été passé et que le plan le permet. Les URL d'upload expirent après 15 minutes : effectuez l'upload immédiatement après la création du transfert.

Gérer l'approbation

Lorsque le champ approval_required est activé sur un transfert, le destinataire ne peut télécharger les fichiers qu'après validation d'un approbateur. Ajoutez un approbateur via POST /v1/transfers/{id}/approvers en passant approver_email ou approver_user_id. Un e-mail de demande d'approbation est envoyé automatiquement. L'approbateur (ou un administrateur via l'API) rend ensuite sa décision via POST /v1/transfers/{id}/approve avec decision: "approved" ou decision: "rejected" et un champ note optionnel. Ce flux nécessite le scope transfers:manage.

Erreurs

Les erreurs portent sur une validation du corps (option incompatible avec le plan) ou un scope manquant. Le tableau ci-dessous indique la résolution.

Voir aussi

• Lister et filtrer les transferts
• Prolonger l'expiration d'un transfert
• Gérer le mot de passe d'un transfert
• Référence API : POST /v1/transfers
• Référence API : POST /v1/transfers/{id}/approve
• Référence API : POST /v1/transfers/{id}/approvers