Résoudre un transfert depuis une URL ou un code court

Requête exemple

{
  "url": "https://files.coffrify.com/abc123?ml=eyJ0eXAi"
}

Réponse exemple

{
  "state": {
    "is_active": true,
    "is_deleted": false,
    "is_expired": false,
    "scan_clean": true,
    "downloads_capped": false
  },
  "transfer": {
    "id": "6b2f0e1a-9c4d-4e7a-bf21-0d3a8c5f1e22",
    "status": "active",
    "user_id": "a1d4c7f2-3b8e-4d09-9f1c-2e6b0a7d5c43",
    "created_at": "2026-06-05T09:30:00.000Z",
    "expires_at": "2026-06-20T12:00:00.000Z",
    "short_code": "abc123",
    "scan_status": "clean",
    "max_downloads": 50,
    "transfer_title": "Contrat de cession Q2",
    "encryption_mode": "e2e",
    "total_downloads": 12,
    "is_password_protected": true
  },
  "share_url": "https://files.coffrify.com/abc123",
  "next_tools": [
    "coffrify_get_transfer",
    "coffrify_get_transfer_timeline",
    "coffrify_list_transfer_downloads"
  ],
  "resolved_from": "url"
}

Cet endpoint prend une URL de partage publique (ou un code court brut) et renvoie les métadonnées du transfert correspondant uniquement s'il appartient au workspace de la clé API appelante. C'est l'outil idéal pour transformer un lien collé par un utilisateur (par exemple https://files.coffrify.com/abc123) en un identifiant de transfert exploitable par les autres endpoints. Par conception, si le code court n'existe pas dans votre workspace, l'API répond 404 sans jamais indiquer s'il existe ailleurs : aucune fuite d'information sur les transferts d'autres workspaces.

L'extraction du code court est tolérante sur la forme de l'entrée. Sont acceptés : l'URL canonique https://files.coffrify.com/<code> (avec ou sans paramètre magic link ?ml= ou fragment E2E #k=, le fragment n'atteignant jamais le serveur), les URL héritées https://coffrify.fr/t|r|c/<code>, ainsi qu'un code court nu de 4 à 32 caractères alphanumériques ou tirets. La réponse précise via resolved_from si la résolution provient du champ short_code ou du champ url.

Authentification

Requiert une clé API valide portant le scope transfers:read. Sans ce scope, l'API répond 403 avec le code scope_missing.

Corps de la requête

Fournissez soit url soit short_code. Si les deux sont présents, short_code est prioritaire. Au moins l'un des deux doit aboutir à un code court valide, sinon l'API répond 400.

Réponse

La réponse renvoie resolved_from ("short_code" ou "url"), l'objet transfer avec ses métadonnées (id, short_code, transfer_title, status, expires_at, max_downloads, total_downloads, scan_status, encryption_mode, is_password_protected, user_id, created_at), l'URL canonique share_url, ainsi qu'un bloc state calculé côté serveur.

Le bloc state synthétise le cycle de vie : is_active (statut active, non expiré et plafond de téléchargements non atteint), is_expired (date expires_at dépassée), downloads_capped (total_downloads >= max_downloads), is_deleted (statut deleted) et scan_clean (analyse antivirus clean ou non encore renseignée). Le champ next_tools suggère les outils à enchaîner.

Erreurs

Voir aussi

• GET /v1/transfers/{id} — détail complet d'un transfert (outil coffrify_get_transfer).
• GET /v1/transfers/{id}/timeline — chronologie des évènements (outil coffrify_get_transfer_timeline).
• GET /v1/transfers/{id}/downloads — liste des téléchargements (outil coffrify_list_transfer_downloads).