Cloner ou prolonger la durée d'un transfert existant

Deux endpoints complémentaires couvrent la gestion du cycle de vie d'un transfert après sa création. Cloner (POST /v1/transfers/{id}/clone) crée un nouveau transfert avec un short_code inédit et un compteur de téléchargements remis à zéro, tout en réutilisant les objets de stockage existants : aucun re-téléversement n'est nécessaire. Prolonger (POST /v1/transfers/{id}/extend) repousse la date d'expiration d'un transfert actif ou expiré, dans la limite de la durée maximale autorisée par votre plan. Dans les deux cas, le plafond de rétention est lu en temps réel depuis coffrify_stripe_products.retention_days, ce qui garantit la cohérence avec votre abonnement.

Authentification

Les deux endpoints exigent le scope transfers:write. Transmettez votre clé API dans l'en-tête Authorization: Bearer <clé>. En environnement de test, utilisez une clé préfixée cof_test_… ; en production, une clé cof_live_…. Le format cof_sandbox_… est accepté sur les workspaces en mode démo.

Corps de la requête

Le corps diffère selon l'opération : le clonage n'a pas de corps obligatoire, la prolongation attend une durée (hours) ou une date (until). Le tableau ci-dessous détaille les champs par endpoint.

Exemples d'appel

Les exemples ci-dessous clonent un transfert, puis repoussent l'expiration d'un autre. Choisissez votre langage.

# --- Clone avec slug personnalisé ---
curl -X POST https://api.coffrify.com/v1/transfers/txf_abc123/clone \
  -H "Authorization: Bearer cof_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"expires_in_hours": 72, "custom_slug": "rapport-q2-2026"}'
 
# --- Extend via nombre d'heures ---
curl -X POST https://api.coffrify.com/v1/transfers/txf_abc123/extend \
  -H "Authorization: Bearer cof_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"hours": 48}'
 
# --- Extend jusqu'a une date précise ---
curl -X POST https://api.coffrify.com/v1/transfers/txf_abc123/extend \
  -H "Authorization: Bearer cof_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"until": "2026-09-01T23:59:59Z"}'

Réponses

Le clonage renvoie un nouveau transfert (201) avec un short_code neuf et un compteur de téléchargements remis à zéro. La prolongation renvoie le transfert mis à jour avec sa nouvelle échéance.

// POST /clone → HTTP 201
{
  "transfer": {
    "id": "txf_xyz789",
    "short_code": "rapport-q2-2026",
    "transfer_title": "Livrables Q2 2026",
    "status": "active",
    "expires_at": "2026-06-09T10:00:00.000Z",
    "max_downloads": 10,
    "total_downloads": 0,
    "encryption_mode": "server",
    "created_at": "2026-06-06T10:00:00.000Z"
  },
  "share_url": "https://files.coffrify.com/rapport-q2-2026",
  "cloned_from": "txf_abc123",
  "reused_files": 3
}
 
// POST /extend → HTTP 200
{
  "transfer_id": "txf_abc123",
  "short_code": "livrables-q1",
  "previous_expires_at": "2026-06-07T08:00:00.000Z",
  "new_expires_at": "2026-06-09T10:00:00.000Z",
  "plan": "pro",
  "plan_cap_hours": 720
}

Erreurs

Les erreurs portent sur un transfert introuvable, une durée hors plafond du plan ou un scope manquant. Le tableau ci-dessous indique la résolution.

Voir aussi

• Créer un transfert
• Gérer les fichiers d'un transfert
• Protéger un transfert par mot de passe
• Référence complète : Transfers
• POST /v1/transfers/{id}/clone
• POST /v1/transfers/{id}/extend