Requête exemple
Réponse exemple
Récupère les détails complets d'un transfert unique appartenant à votre espace de travail, identifié par son id (UUID). En plus de toutes les colonnes du transfert (statut, expiration, protections, mode de chiffrement, compteurs de téléchargement), la réponse inclut un tableau files listant les fichiers rattachés. Comportement notable : la requête est strictement filtrée sur le workspace_id du token, donc un identifiant existant mais appartenant à un autre espace renvoie 404 not_found plutôt que 403, ce qui évite toute fuite d'information entre espaces. L'endpoint ne déchiffre rien et n'expose jamais de secret (password_hash et totp_secret restent des valeurs internes, ne les utilisez pas côté client).
Authentification
Requiert une clé API valide passée via Authorization: Bearer cof_live_... (ou cof_test_..., cof_rk_..., cof_mcp_...). Le scope requis est transfers:read. Une clé restreinte sans ce scope est rejetée avec scope_missing (403). S'agissant d'une lecture (GET), l'endpoint n'applique pas d'idempotence et compte sur le quota de débit de classe read de votre espace.
Paramètres de requête
Aucun paramètre de requête (query string). Le seul paramètre est le segment de chemin id.
| Paramètre | Emplacement | Type | Requis | Description |
|---|---|---|---|---|
| id | chemin (path) | string (UUID) | Oui | Identifiant du transfert à récupérer. Doit appartenir à l'espace de travail du token, sinon 404. |
Réponse
Renvoie l'objet transfert avec l'ensemble de ses colonnes, augmenté d'un tableau files. Champs clés : id et short_code (code court public), status (active, scheduled, expired ou deleted), expires_at et scheduled_at (dates ISO 8601), is_password_protected et require_totp (protections d'accès), max_downloads et total_downloads (quota et usage), auto_delete et burn_after_read (cycle de vie), encryption_mode (server_side ou e2e_v1) avec encryption_metadata, scan_status/scan_result (analyse antivirus), les listes ip_allowlist/ip_blocklist/geo_allowlist/geo_blocklist, ainsi que transfer_title, notes, folder_id et workspace_id. Le tableau files contient, pour chaque fichier : id, file_name, file_size (octets), file_type (MIME) et created_at. Il vaut [] si le transfert n'a aucun fichier.
Erreurs
| Code HTTP | Code | Quand | Comment résoudre |
|---|---|---|---|
| 401 | missing_api_key | En-tête Authorization absent | Ajoutez Authorization: Bearer cof_live_.... |
| 401 | invalid_api_key | Préfixe de clé invalide ou clé inconnue/révoquée | Vérifiez la valeur et l'environnement de la clé (live vs test). |
| 403 | scope_missing | La clé (restreinte) ne porte pas transfers:read | Régénérez une clé incluant le scope transfers:read. |
| 404 | not_found | Aucun transfert avec cet id dans l'espace de travail | Vérifiez l'id et que le transfert appartient bien à l'espace de la clé. |
| 429 | rate_limited | Quota de requêtes/minute (classe read) dépassé | Respectez l'en-tête Retry-After et lissez les appels. |
| 500 | internal_error | Erreur interne lors de la lecture en base | Réessayez ; si cela persiste, contactez le support avec le request_id. |
Voir aussi
GET/v1/transfersListe paginée des transferts de l'espace de travail.GET/v1/transfers/{id}/filesDétail des fichiers d'un transfert.DELETE/v1/transfers/{id}Supprime le transfert (scope transfers:write).