Configuración
API keys
Las API keys te permiten usar la API de Waiify (se abre en una pestaña nueva) desde tus propios sistemas. Se gestionan en Configuración → Desarrolladores.
Crear una API key
Sección titulada «Crear una API key»-
En la sección Desarrolladores, elige Crear API key.
-
Ponle un nombre descriptivo (ej. “Integración ERP”).
-
Copia la clave: solo se muestra una vez. Guárdala en un lugar seguro (un gestor de secretos).
Estados
Sección titulada «Estados»| Estado | Significado |
|---|---|
| Activa | Funciona normalmente |
| Revocada | Desactivada manualmente |
| Expirada | Llegó a su fecha de expiración |
Cada key muestra su prefijo (para identificarla sin exponerla), su fecha de creación y su último uso.
Revocar
Sección titulada «Revocar»Si una clave se filtró o ya no se usa, revócala. Deja de funcionar de inmediato; las integraciones que la usaban deberán cambiar a una nueva.
Buenas prácticas de seguridad
Sección titulada «Buenas prácticas de seguridad»- Una API key da acceso completo a ese workspace, equivalente al dueño (OWNER) — no es un token de solo lectura. Trátala como una contraseña.
- Una key por integración — así puedes revocar una sin afectar las demás.
- Nunca la publiques en código cliente, repositorios o capturas.
- Guárdala en variables de entorno o un gestor de secretos.
- Revoca las que ya no uses.
Cómo se usa
Sección titulada «Cómo se usa»La key se envía en el header Authorization: Bearer <api-key>. Ver autenticación de la API (se abre en una pestaña nueva).
ID del workspace
Sección titulada «ID del workspace»Además de la key, casi todos los endpoints necesitan el ID del workspace en la ruta (/workspaces/:workspaceId/...).
Lo encuentras en esta misma sección Desarrolladores, en la tarjeta ID del workspace: pulsa el botón de copiar y pégalo en tu integración. Si tienes varios workspaces, la tarjeta muestra el del workspace activo — copia el que corresponda a la key que vas a usar, porque una key solo sirve para el workspace donde se creó.
A diferencia de la key, el ID del workspace no es un secreto: puedes volver a consultarlo cuando quieras.
