Pandafile · 50 Go gratuits chaque semaine

API de transfert de fichiers pour vos applications et vos workflows

Pandafile propose une API REST pour envoyer de gros fichiers depuis votre propre code, vos serveurs et vos outils no-code. Créez un transfert, envoyez les fichiers avec reprise automatique, adressez des liens personnels aux destinataires par e-mail et recevez un webhook quand quelqu'un télécharge. L'API fait partie de Pro et Team, suit les mêmes limites que l'application web et est décrite dans un document OpenAPI 3.1 public. Les clés de test vous permettent de développer et de lancer vos tests sans envoyer de vrais e-mails ni utiliser votre stockage.

Lire le guide développeur

Une API REST décrite en OpenAPI 3.1

Tous les endpoints se trouvent sous /api/v1 et parlent JSON. Vous vous authentifiez avec une clé API dans l'en-tête Authorization, sous forme de jeton Bearer. Les clés se créent dans votre tableau de bord, ne s'affichent qu'une seule fois et peuvent être limitées à la lecture seule, à la lecture et l'écriture, ou à l'accès complet : un script de reporting n'a ainsi jamais le pouvoir de supprimer des transferts. L'ensemble de l'API est décrit dans un document OpenAPI 3.1 lisible par machine, à l'adresse /api/v1/openapi.json, que vous pouvez charger dans Postman, utiliser pour générer un client ou confier à un assistant de code IA. Le guide développeur sur /developers explique les concepts, et la référence de l'API sur /developers/api liste chaque endpoint avec des exemples. Chaque réponse contient un identifiant de requête, les limites de débit figurent dans les en-têtes RateLimit, les listes utilisent une pagination par curseur et les erreurs partagent un même format JSON.

Des envois reprenables avec tus

Les gros fichiers et les réseaux instables font mauvais ménage avec une seule longue requête HTTP. Pour envoyer des fichiers, vous créez d'abord un transfert avec POST /api/v1/transfers, en indiquant les fichiers, le titre, le message et, si vous le souhaitez, les adresses e-mail des destinataires. Chaque fichier est ensuite envoyé avec tus, le protocole ouvert d'envoi reprenable : une connexion coupée ou un serveur redémarré reprend au dernier octet au lieu de tout recommencer. Des clients tus prêts à l'emploi existent pour JavaScript, Python, Go, Java, .NET, Swift et bien d'autres. Une fois tous les fichiers arrivés, vous appelez complete, et le transfert devient un lien Pandafile normal, avec page de téléchargement, liens personnels pour les destinataires, relances et expiration. Les limites de la formule sont les mêmes que dans le navigateur : jusqu'à 1000 Go par transfert et 1500 Go de stockage avec Pro.

Envoyer des fichiers directement depuis une URL

Parfois, le fichier se trouve déjà ailleurs : une pièce jointe de CRM, le rendu d'une ferme de calcul ou un export sur un autre serveur. POST /api/v1/transfers/from-url accepte des URL HTTPS et laisse Pandafile récupérer les fichiers pour vous, puis crée et finalise le transfert. La requête attend jusqu'à 20 secondes. Les petits imports reviennent terminés, et les plus gros répondent immédiatement avec le statut uploading pendant que l'import se poursuit en arrière-plan. Vous pouvez suivre la progression avec GET /api/v1/transfers/{id}/import, ou simplement attendre le webhook transfer.ready. C'est aussi ainsi que les intégrations Zapier et Make envoient des fichiers sans que votre workflow ait à les télécharger d'abord.

Webhooks et notifications

Plutôt que d'interroger l'API en boucle, abonnez-vous aux événements. Pandafile peut appeler votre URL quand un transfert est prêt, téléchargé ou expiré, quand un destinataire valide des fichiers ou demande des modifications, quand quelqu'un dépose des fichiers dans l'une de vos demandes de fichiers et quand une demande de signature est terminée. Chaque envoi est signé en HMAC-SHA256 dans un en-tête Pandafile-Signature, pour que vous puissiez vérifier qu'il vient bien de nous, et les envois échoués sont retentés après 1 minute, 5 minutes, 30 minutes, 2 heures et 12 heures. Les événements sont aussi conservés 30 jours et consultables avec GET /api/v1/events. Si vous n'avez pas besoin de code du tout, ces mêmes événements peuvent publier des messages dans Slack, Microsoft Teams ou Discord.

Clés de test, relances sans risque et tout ce que vous pouvez automatiser

Les clés API existent en deux modes. Les clés live commencent par pf_live_ et les clés de test par pf_test_. Les transferts créés avec une clé de test n'envoient jamais d'e-mails, ne comptent jamais dans votre stockage ni votre utilisation, ne sont conservés que 24 heures et n'apparaissent pas dans votre liste de transferts habituelle : vous pouvez lancer vos tests d'intégration contre la vraie API sans effets de bord. Les requêtes POST et PATCH acceptent un en-tête Idempotency-Key, si bien qu'une requête relancée ne crée jamais un second transfert. Au-delà des transferts, l'API couvre les destinataires et les relances, l'historique des téléchargements, les statistiques de lien et les validations, les demandes de fichiers, les demandes de signature, la personnalisation de marque et les invitations d'équipe. L'API est incluse dans Pro, à partir de 5,99 $ par mois ou 49,99 $ par an, et dans Team, à partir de 14,99 $ par mois ou 129,99 $ par an. Dans une équipe, chaque membre dispose de ses propres clés personnelles.

Questions fréquentes

Pandafile a-t-il une API ?

Oui. Pandafile propose une API REST sous /api/v1 pour créer des transferts, envoyer des fichiers, gérer les destinataires, les demandes de fichiers et les demandes de signature, et recevoir des webhooks. Elle est incluse dans les formules Pro et Team.

Où se trouve la documentation de l'API ?

Le guide développeur se trouve sur /developers et la référence complète de l'API, avec des exemples, sur /developers/api. Le document OpenAPI 3.1 lisible par machine est public à l'adresse /api/v1/openapi.json.

Les envois peuvent-ils reprendre si la connexion coupe ?

Oui. Les fichiers sont envoyés avec le protocole tus d'envoi reprenable : un envoi interrompu reprend là où il s'était arrêté au lieu de recommencer à zéro.

Puis-je tester sans envoyer de vrais e-mails ?

Oui. Utilisez une clé de test commençant par pf_test_. Les transferts de test n'envoient jamais d'e-mails, ne comptent pas dans votre stockage ni votre utilisation, et sont supprimés au bout de 24 heures.

Puis-je envoyer un fichier qui est déjà en ligne ?

Oui. POST /api/v1/transfers/from-url récupère des fichiers depuis des URL HTTPS et les transforme en transfert. Les imports plus lourds se poursuivent en arrière-plan, et le webhook transfer.ready vous prévient quand le lien est prêt.

Lire le guide développeur

Pages populaires