Clés API, portées et mode test
Avec Pro et Team, crée des clés API dans Tableau de bord > Domaine et API. Chaque clé a une portée (Lecture seule, Lecture et écriture ou Accès complet) et un mode : les clés de production (pf_live_) agissent pour de vrai, les clés de test (pf_test_) n'envoient jamais d'e-mail et leurs transferts expirent au bout de 24 heures.
L'API Pandafile permet à tes propres applications, scripts et serveurs d'envoyer des fichiers, de collecter des dépôts et de demander des signatures. Elle est incluse dans Pro et Team et suit les mêmes limites que le site. Tout commence par une clé API.
Créer une clé
- Connecte-toi et ouvre Tableau de bord > Domaine et API.
- Sous Clés API, donne un nom à la clé, par exemple Dépôts du site.
- Choisis le mode de la clé, Production ou Test, et l'accès de la clé : Accès complet, Lecture et écriture ou Lecture seule.
- Clique sur Créer une clé et copie-la immédiatement. Pour ta sécurité, nous ne l'affichons qu'une seule fois.
- Envoie-la avec chaque requête dans l'en-tête Authorization: Bearer suivi de la clé.
Tu peux avoir jusqu'à 10 clés actives. Les clés de production commencent par pf_live_ et les clés de test par pf_test_. Le guide du développeur se trouve sur pandafile.co/developers et la référence de l'API sur pandafile.co/developers/api.
Portées : ce qu'une clé peut faire
- Lecture seule : uniquement des requêtes GET. La clé peut consulter des informations mais ne rien modifier.
- Lecture et écriture : tout ce que permet Lecture seule, plus créer, modifier et supprimer des transferts, des demandes de fichiers, des demandes de signature et des abonnements webhook.
- Accès complet : tout, y compris les paramètres du compte comme l'image de marque et les invitations d'équipe.
Mode test
- Les transferts créés avec une clé pf_test_ sont des données de test. Personne ne reçoit jamais d'e-mail, pas même les destinataires que tu ajoutes.
- Les transferts de test expirent toujours 24 heures après leur création et ne peuvent pas être prolongés.
- Ils ne comptent dans aucune limite, ni dans ton stockage ni dans ton utilisation, et n'apparaissent pas dans tes listes de transferts habituelles.
- Les événements webhook qui les concernent ont livemode à false, et ils ne partent jamais vers Slack, Microsoft Teams ou Discord.
- Quelques actions ne fonctionnent qu'avec une clé de production. Avec une clé de test, l'API répond alors avec l'erreur test_mode_unsupported.
Protéger tes clés
- Toute personne qui a une clé peut envoyer des fichiers depuis ton compte. Garde les clés sur ton serveur, jamais dans le code public d'un site ou d'une application.
- Révoque une clé dans Tableau de bord > Domaine et API si elle a pu fuiter. Les applications qui l'utilisent cessent aussitôt de fonctionner, tout comme les abonnements webhook créés avec elle, par exemple par Zapier ou Make.
- Chaque clé a sa propre limite de requêtes. Chaque réponse indique où tu en es dans les en-têtes RateLimit.
- Dans une équipe, les clés API sont personnelles : chaque membre crée les siennes.