Claves API, permisos y modo de prueba

4 min de lectura · Actualizado el 2026-11-15

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

  1. Inicia sesión y abre Panel > Dominio y API.
  2. En Claves API, ponle un nombre a la clave, por ejemplo Subidas de la web.
  3. Elige el modo de la clave, Real o Prueba, y el acceso de la clave: Acceso total, Lectura y escritura o Solo lectura.
  4. Pulsa Crear clave y cópiala enseguida. Por tu seguridad, solo la mostramos una vez.
  5. 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.
¿Listo para enviar?

Hasta 50 GB gratis por transferencia, sin cuenta.

Enviar archivos