Guides & tutoriels. Du premier appel à la production.
Des guides concrets, ancrés sur l'API réelle, classés par thème. Choisissez une catégorie.
🚀Prise en main
Créez votre compte, vos clés et votre premier transfert chiffré.
Créer une clé API et choisir les bons scopes
Générez une clé API Coffrify, sélectionnez les scopes adaptés à votre cas d'usage et comprenez les contraintes de sécurité (MFA, clés restreintes, expiration).
Valider son intégration avec le diagnostic complet
Apprenez à utiliser les deux endpoints de diagnostic de l'API Coffrify pour vérifier la santé de votre intégration en temps réel et suivre la progression de votre configuration.
Gérer vos environnements staging et production
Apprenez à distinguer les clés test, live et sandbox, à vérifier votre contexte courant via GET /v1/me et à lister vos workspaces via GET /v1/workspaces sans jamais risquer de données réelles en production.
Authentification : clés API et scopes
Créez, sécurisez et gérez vos clés API Coffrify pour autoriser chaque appel avec les permissions exactes dont votre intégration a besoin.
Idempotence : éviter les doublons avec Idempotency-Key
Apprenez à utiliser l'en-tête Idempotency-Key pour rejouer en toute sécurité vos appels POST et ne jamais créer deux transferts ou deux requêtes par accident.
Parcourir de grandes listes avec la pagination par curseur
Apprenez à itérer de façon stable et performante sur vos transferts, rooms et collections grâce au mécanisme de curseur de l'API Coffrify.
📦Transferts
Créer, sécuriser, lister et télécharger des transferts via l'API.
Implémenter un workflow d'approbation de transfert
Apprenez à mettre en place un circuit de validation complet pour vos transferts Coffrify : ajout d'approbateurs, décision approuvé/rejeté et propagation automatique du statut.
Cloner ou prolonger la durée d'un transfert existant
Apprenez à dupliquer un transfert avec un nouveau lien de partage ou à repousser sa date d'expiration, sans re-téléverser les fichiers.
Créer un transfert avec options avancées (expiration, mot de passe, approbation)
Apprenez à créer un transfert via l'API Coffrify en configurant l'expiration, la protection par mot de passe et le circuit d'approbation.
Exporter la liste complète des transferts en CSV
Téléchargez en une seule requête l'intégralité de vos transferts au format CSV ou JSON, avec filtrage par statut et plafond configurable jusqu'à 10 000 lignes.
Créer et partager un transfert chiffré
Créez un transfert chiffré AES-256-GCM, uploadez vos fichiers sur les URLs présignées et partagez le lien sécurisé en quelques appels API.
Générer une URL de téléchargement signée et éphémère
Obtenez en un appel POST une URL S3 pré-signée à durée de vie configurable pour télécharger n'importe quel fichier d'un transfert, sans passer par la porte publique ni incrémenter le compteur de téléchargements.
📥Réception
Recevoir des fichiers confidentiels en chiffrement de bout en bout, via widget ou SDK.
Recevoir des fichiers en 5 min (no-code)
Tutoriel pas à pas pour créer un intake, coller le widget sur votre site et récupérer un premier dépôt chiffré, sans écrire la moindre ligne de back.
Intégration headless avec @coffrify/sdk
Tutoriel pas à pas pour intégrer Coffrify Intake en mode headless avec @coffrify/sdk côté Node et la classe Coffrify.Intake côté navigateur, de la création de l'intake à la récupération des dépôts.
🔔Webhooks
Recevez les évènements en temps réel et vérifiez la signature HMAC.
Catalogue complet des événements webhook disponibles
Découvrez les 74 types d'événements webhook Coffrify, regroupés par famille, avec leurs conditions de déclenchement et les plans requis.
Configurer un webhook
Créez, sécurisez et testez vos webhooks Coffrify pour recevoir des notifications en temps réel sur les événements de votre espace de travail.
Rejouer manuellement une livraison webhook échouée
Apprenez à rejouer ou forcer la réexécution d'une livraison webhook abandonnée via les endpoints POST /replay et POST /retry de l'API Coffrify.
Effectuer une rotation du secret de signature sans interruption
Renouvelez le secret HMAC d'un Webhook Coffrify en conservant l'ancien valide pendant une fenêtre de grâce configurable, pour ne perdre aucune livraison.
Simuler un événement webhook en environnement de test
Envoyez une livraison signée vers votre endpoint pour valider la logique de traitement d'un type d'événement précis, sans attendre qu'un vrai événement se produise en production.
Comprendre la stratégie de retry et configurer le back-off
Apprenez comment Coffrify rejoue automatiquement vos Webhooks en cas d'échec, comment consulter l'historique des tentatives et comment forcer une ré-exécution manuelle via l'API.
🛡️Sécurité & conformité
Chiffrement, scopes, IP allowlist, rétention et RGPD.
Auditer l'activité d'une clé API (derniers appels, IPs, scopes utilisés)
Consultez l'historique détaillé des appels d'une clé API Coffrify : IPs source, codes HTTP, routes les plus actives et histogramme journalier sur 1 à 90 jours.
Gérer les consentements et droits d'accès RGPD via l'API
Interrogez le journal de consentements de votre espace de travail, vérifiez l'état d'acceptation de vos documents juridiques et déposez une demande d'accès RGPD (Art. 15) directement via l'API Coffrify.
Exporter les logs d'audit pour conformité RGPD
Générez un export complet de votre journal d'audit (CSV ou JSON) via l'API Coffrify, récupérez l'URL de téléchargement sécurisée, et déclenchez en parallèle l'export portabilité RGPD (Art. 20).
Configurer la politique de rétention et déclencher la suppression
Consultez les durées de conservation par catégorie de données et soumettez une demande d'effacement RGPD (Art. 17) via l'API Coffrify.
Effectuer une rotation de clé API sans coupure de service
Remplacez une clé API existante par une nouvelle tout en conservant l'ancienne active pendant une fenêtre de grâce configurable, afin de déployer le changement côté appelant sans aucune interruption.
🤖Agents IA (MCP)
Branchez Coffrify à vos agents IA via le Model Context Protocol.
Construire un agent qui crée et livre des transferts automatiquement
Apprenez à orchestrer un agent Python complet qui provisionne un token MCP, crée un transfert chiffré et diagnostique son état via l'API Coffrify.
Connecter un MCP server hébergé à votre workspace
Découvrez comment utiliser l'endpoint de contrôle du MCP server hébergé Coffrify pour vérifier la disponibilité, récupérer les URL de transport et initialiser une session JSON-RPC depuis votre application.
Créer des custom actions MCP pour automatiser un workflow
Apprenez à créer, configurer et invoquer des custom actions MCP pour brancher vos propres workflows sur l'API Coffrify.
Émettre un token MCP pour un agent IA autonome
Créez, gérez et révoquez des tokens MCP dédiés aux agents IA autonomes afin de leur accorder un accès granulaire et auditable aux ressources de votre workspace Coffrify.
Lister et inspecter les outils MCP disponibles
Découvrez comment récupérer le catalogue complet des 207 outils MCP de votre workspace Coffrify et activez ou désactivez chacun d'eux via l'API.
Brancher Coffrify à Claude Desktop
Générez un token MCP dédié, configurez Claude Desktop en moins de cinq minutes et laissez votre assistant IA piloter vos transferts, webhooks et toute la surface API Coffrify.
🧰SDK & CLI
Installez et utilisez les SDK Node, Python, Go et la CLI.
Uploader des fichiers en batch avec le CLI coffrify
Créez un transfert multi-fichiers en une seule requête POST, récupérez les URL de mise en ligne signées, déposez chaque fichier directement dans le stockage, puis vérifiez l'inventaire via l'endpoint dédié.
Gérer les erreurs et les retries automatiques dans le SDK
Apprenez à identifier, intercepter et relancer automatiquement les erreurs de l'API Coffrify grâce aux codes d'erreur normalisés, aux headers de rate-limit et aux utilitaires de retry intégrés au SDK.
Installer et configurer le SDK Node.js / TypeScript
Installez le SDK Coffrify, configurez votre clé API et effectuez votre premier appel en quelques minutes.
Installer et utiliser le SDK Python (coffrify-python)
Installez le SDK Python officiel de Coffrify, authentifiez-vous avec votre clé API et créez votre premier transfert chiffré en quelques lignes de code.
Intégrer le SDK Go dans une application serveur
Apprenez à installer le SDK Go de Coffrify, à vous authentifier avec une clé API et à créer des transferts, inscrire des webhooks et interroger le contexte de votre clé depuis une application serveur Go.
🗂️Data Rooms & Collections
Espaces sécurisés, accès invités et collections de fichiers.
Créer des collections réutilisables depuis des templates
Apprenez à combiner les templates de transfert et les collections Coffrify pour industrialiser la distribution de vos data rooms M&A, juridiques ou financières.
Créer une Data Room M&A avec membres et permissions
Créez une Data Room sécurisée, invitez vos contreparties avec des rôles précis et gérez leur accès via un lien magique, le tout en quelques appels API.
Gérer les membres et invitations d'une Data Room
Listez les membres d'une Data Room, invitez un collaborateur via un magic link et révoquez son accès en une seule requête DELETE.
Organiser : dossiers, collections et coffres
Apprenez à structurer vos transferts avec des dossiers, à publier des vitrines partageables via les collections et à créer des espaces sécurisés avec les coffres.
Organiser les fichiers avec dossiers et collections imbriqués
Apprenez à structurer vos transferts en dossiers colorés et en collections imbriquées avec sections, items et contrôle de visibilité.
Partager un document depuis une Data Room avec lien sécurisé
Attachez un transfert existant à une Data Room, puis générez un lien de téléchargement présigné à durée limitée pour un partage confidentiel et traçable.
📥Inbox & demandes de fichiers
Recevez des fichiers via des demandes et des boîtes de dépôt.
Créer une drop-box publique pour recevoir des fichiers anonymes
Apprenez à déclarer une drop-box via l'interface Coffrify, à générer un token `cit_live_…`, puis à soumettre un dépôt côté serveur avec l'endpoint POST /v1/inbox/submit.
Envoyer une demande de fichier ciblée à un destinataire
Créez une demande de fichier restreinte à une liste d'adresses e-mail autorisées, récupérez son identifiant et exploitez les soumissions reçues via l'API Coffrify.
Recevoir des fichiers : les demandes
Créez une page de dépôt publique, recevez des soumissions et gérez leur cycle de vie complet depuis l'API Coffrify.
Recevoir des notifications webhook à chaque dépôt dans l'Inbox
Configurez un webhook Coffrify pour être alerté en temps réel à chaque nouveau dépôt dans votre Inbox, et vérifiez la signature HMAC pour sécuriser la réception.
Sécuriser une Inbox avec chiffrement de bout en bout (sealed-box X25519)
Activez le mode E2E sur votre drop-box Coffrify : générez une paire de clés X25519 dans le navigateur, stockez la clé privée enveloppée (PBKDF2 + AES-256-GCM), puis soumettez chaque dépôt avec un `encryption_mode: "e2e_v1_asym"` pour que Coffrify ne voie jamais le contenu en clair.
Traiter et router automatiquement les fichiers reçus dans l'Inbox
Apprenez à soumettre des fichiers dans une drop-box via l'API, à surveiller les soumissions avec des webhooks et à mettre à jour le statut d'une demande de fichiers de façon programmatique.
💳Facturation & quotas
Quotas, consommation, plans et facturation via l'API.
Configurer des alertes de dépassement de quota
Créez des règles d'alerte automatiques pour être notifié dès qu'un quota de stockage, de bande passante ou de transferts actifs approche ou dépasse la limite de votre plan.
Consulter l'usage et les quotas en temps réel
Interrogez les endpoints /v1/quotas/check, /v1/quotas/bandwidth, /v1/quotas/storage, /v1/quotas/throughput et /v1/billing/usage pour surveiller la consommation de votre workspace et anticiper les dépassements de quota.
Générer un lien vers le portail de facturation Stripe
Créez en un appel une URL authentifiée vers le portail Stripe pour que vos utilisateurs puissent consulter leurs factures, mettre à jour leur moyen de paiement ou résilier leur abonnement.
Surveiller les quotas de bande passante et de stockage
Interrogez les trois endpoints de quotas pour connaître en temps réel l'utilisation de votre espace de stockage, la consommation de bande passante et les seuils de votre plan.
Obtenir un snapshot d'abonnement et une recommandation de plan
Interrogez l'API Coffrify pour obtenir l'usage facturable en temps réel du cycle courant, le bilan du mois précédent et une recommandation automatique de plan fondée sur 30 jours de consommation.
📊Observabilité & erreurs
Logs, codes d'erreur, idempotence et limites de débit.
Analyser les top transferts et destinataires avec l'API analytics
Interrogez les trois endpoints d'analytics Coffrify pour obtenir un résumé d'usage, les transferts les plus téléchargés et les destinataires les plus actifs sur votre workspace.
Comprendre et traiter tous les codes d'erreur de l'API
Apprenez à lire les codes d'erreur structurés de l'API Coffrify, à consulter leur catalogue de diagnostic et à mettre en place une gestion robuste des cas d'échec dans vos intégrations.
Filtrer et exporter les logs d'audit par acteur, action et période
Interrogez le journal d'audit de votre workspace avec des filtres précis, pagininez les résultats par curseur et déclenchez un export CSV ou JSON conforme RGPD stocké 24 h sur Scaleway.
Mesurer le taux de conversion et la géolocalisation des téléchargements
Interrogez les trois endpoints analytics de Coffrify pour obtenir votre entonnoir de conversion, la répartition géographique des téléchargements et la heatmap hebdomadaire d'activité.
Récupérer la timeline complète d'activité d'un transfert
Interrogez l'endpoint /v1/transfers/{id}/timeline pour obtenir, en un seul appel, tous les événements chronologiques d'un transfert : création, téléchargements, magic links, webhooks et entrées d'audit.