Saltar al contenido principal
Todas las requests a la API requieren un Bearer token en el header Authorization. Te autenticas usando una API key que comienza con faces_.

​
Equipos y keys

Cada API key está asociada a un único equipo. Los proyectos creados con una key son propiedad de ese equipo, y la key solo puede leer o editar proyectos a los que su equipo (o el propietario de la key) tenga acceso. Cuando creas una key desde el panel o la CLI, queda asociada a tu equipo personal por defecto. Elige un equipo distinto al momento de crearla si necesitas automatizar bajo un equipo compartido. Usa GET /api/v1/teams para listar los equipos a los que pertenece tu cuenta (junto con el rol que tienes en cada uno). Esto es útil cuando automatizas la creación de keys o cuando necesitas verificar bajo qué equipo opera una key.

​
Crear una API key

​
Opción 1: Desde el panel (recomendado)

  1. Inicia sesión en faces.app
  2. Abre Configuración desde la barra lateral izquierda
  3. Haz clic en Desarrolladores
  4. Ingresa un nombre para tu key (por ejemplo, “Mi script”) y haz clic en Crear key
  5. Copia la key inmediatamente. Solo se muestra una vez.
Configuración para desarrolladores con el campo de nombre de la API key y el botón Crear key
Las API keys se muestran una sola vez al momento de crearlas. Si la pierdes, revócala y crea una nueva.

​
Opción 2: Usando la CLI

La CLI gestiona la autenticación automáticamente:
Esto abre tu navegador, inicia sesión, crea una key llamada “CLI” y la guarda en ~/.config/faces/credentials.json. Pasa --team <slug-or-id> para asociar la key a un equipo compartido en lugar de tu equipo personal:

​
Usar la key

Incluye la key como un Bearer token en cada request:

​
Revocar keys

Puedes revocar keys desde Configuración > Desarrolladores en el panel. Revocar una key la invalida de forma inmediata y permanente. Cualquier integración que use esa key dejará de funcionar.

​
Buenas prácticas de seguridad

  • Nunca subas API keys al control de versiones
  • Usa variables de entorno para almacenar las keys:
  • Crea keys separadas para cada integración para poder revocarlas de forma independiente
  • Rota las keys periódicamente creando una nueva y revocando la anterior