Skip to main content

​
Dónde se gestionan

Tus API keys se administran desde la Console (console.ipsofactura.com), en la sección API keys: ahí puedes crearlas con un nombre descriptivo, ver su prefijo y revocarlas. Las credenciales iniciales se entregan durante el onboarding. Cada ambiente tiene sus propias keys: una key de producción no funciona en el sandbox, ni viceversa.

​
Reglas

  • Máximo 5 keys activas por cuenta. Si necesitas más espacio, revoca una que ya no uses.
  • El valor completo se muestra una sola vez, al crearla. Solo almacenamos un hash: si pierdes la key no podemos recuperarla — crea una nueva y revoca la perdida.
  • Cada key se identifica después por su prefijo (los primeros 13 caracteres), visible en la Console y en los logs de API.
  • Hoy no hay expiración automática ni restricción por IP: una key es válida hasta que la revoques. Ambas capacidades están en el roadmap.

​
Rotación sin downtime

El tope de 5 keys activas existe justo para poder rotar sin interrumpir el servicio:
1

Crea la key nueva

Desde la Console. Guarda el valor en tu gestor de secretos.
2

Despliega tu sistema con la key nueva

Ambas keys funcionan en paralelo mientras migras.
3

Revoca la key anterior

Cuando confirmes que ya no hay tráfico con el prefijo viejo (visible en tus logs de API), revócala. La revocación es inmediata: las requests con esa key reciben 401 INVALID_API_KEY.

​
Buenas prácticas

Nunca expongas una API key en código cliente (frontend, apps móviles) ni la subas a un repositorio. Haz las llamadas siempre desde tu backend y guarda la key en un gestor de secretos.
  • Usa una key por sistema/integración (el nombre te ayuda a saber cuál revocar).
  • Monitorea el uso por prefijo para detectar keys olvidadas.