Claves API, permisos y modo de prueba
Respuesta corta
Con Pro y Team, crea claves API en Panel > Dominio y API. Cada clave tiene un permiso (Solo lectura, Lectura y escritura o Acceso total) y un modo: las claves reales (pf_live_) funcionan de verdad y las de prueba (pf_test_) nunca envían correos y sus transferencias caducan a las 24 horas.
La API de Pandafile permite que tus propias apps, scripts y servidores envíen archivos, recojan subidas y pidan firmas. Está incluida en Pro y Team y sigue los mismos límites que la web. Todo empieza con una clave API.
Crear una clave
- Inicia sesión y abre Panel > Dominio y API.
- En Claves API, ponle un nombre a la clave, por ejemplo Subidas de la web.
- Elige el modo de la clave, Real o Prueba, y el acceso de la clave: Acceso total, Lectura y escritura o Solo lectura.
- Pulsa Crear clave y cópiala enseguida. Por tu seguridad, solo la mostramos una vez.
- Envíala con cada petición en la cabecera Authorization: Bearer seguida de la clave.
Puedes tener hasta 10 claves activas. Las claves reales empiezan por pf_live_ y las de prueba por pf_test_. La guía para desarrolladores está en pandafile.co/developers y la referencia de la API en pandafile.co/developers/api.
Permisos: qué puede hacer una clave
- Solo lectura: solo peticiones GET. La clave puede consultar datos, pero no cambiar nada.
- Lectura y escritura: todo lo de Solo lectura, más crear, cambiar y borrar transferencias, solicitudes de archivos, solicitudes de firma y suscripciones de webhook.
- Acceso total: todo, incluidos los ajustes de la cuenta, como la marca y las invitaciones al equipo.
Modo de prueba
- Las transferencias hechas con una clave pf_test_ son datos de prueba. Nunca se envía ningún correo, ni siquiera a los destinatarios que añadas.
- Las transferencias de prueba siempre caducan 24 horas después de crearse y no se pueden ampliar.
- No cuentan para ningún límite, almacenamiento ni uso, y no aparecen en tus listas normales de transferencias.
- Los eventos de webhook sobre ellas llevan livemode en false y nunca se envían a Slack, Microsoft Teams ni Discord.
- Algunas acciones solo funcionan con una clave real. Con una clave de prueba, la API responde entonces con el error test_mode_unsupported.
Mantén tus claves a salvo
- Cualquiera que tenga una clave puede enviar archivos desde tu cuenta. Guarda las claves en tu servidor, nunca en el código público de una web o una app.
- Revoca una clave en Panel > Dominio y API si puede haberse filtrado. Las apps que la usan dejan de funcionar al instante, y también las suscripciones de webhook creadas con ella, por ejemplo por Zapier o Make.
- Cada clave tiene su propio límite de peticiones. Cada respuesta te dice cómo vas en las cabeceras RateLimit.
- En un equipo, las claves API son personales: cada miembro crea las suyas.