Référence APICréer un magic link
POST/v1/magic-links

Créer un magic link

Émet un magic link d'accès.

1 min de lectureTélécharger en PDF

Requête exemple

{
"transfer_id": "tr_abc123def456",
"expires_in_minutes": 30
}

Réponse exemple

{
"id": "mlink_uvw123",
"token": "mlink_x1y2z3...full-secret",
"warning": "Save this token now - it will not be shown again.",
"magic_url": "https://files.coffrify.com/ABC123?ml=mlink_x1y2z3...",
"expires_at": "2026-06-05T15:00:00Z",
"short_code": "ABC123",
"transfer_id": "tr_abc123def456",
"expires_in_minutes": 30
}

Crée un magic link pour un transfert (accès sans authentification). Le token et l'URL complète ne sont renvoyés qu'à la création.

Authentification

Requiert une clé API avec le scope magic_links:manage.

Corps de la requête

ChampTypeRequisDescription
transfer_idstringOuiTransfert à lier.
expires_in_minutesnumberNonValidité en minutes (1 à 1440, défaut 10).

Codes de statut

  • 201 Magic link créé.
  • 400 transfer_id manquant.
  • 404 Transfert introuvable.
  • 403 Scope insuffisant.