Obtén tu clave API de Screeb
Encuentra la clave API de tu Workspace, úsala para enviar datos y Releases a Screeb desde tu backend y restablécela si se filtra.
Esta página se tradujo automáticamente. La versión en inglés es la referencia.
La clave API del Workspace permite que tus propios servidores hablen con Screeb, sin el tag ni un SDK móvil. Cada Workspace tiene una clave.
Antes de empezar
Sección titulada «Antes de empezar»- La página Screeb API y el restablecimiento de la clave son para los miembros con el rol Administrador en la organización.
- Un Editor o un Administrador del Workspace puede copiar la clave desde Releases, consulta Restablecer la clave. Un Analista no puede verla.
- La clave es un secreto: quien la tenga puede enviar datos a tu Workspace. Guárdala en tus servidores, nunca en el código de tu sitio o app.
Copiar la clave
Sección titulada «Copiar la clave»- En la barra lateral del Workspace, haz clic en Configuración y, en Datos y despliegue, haz clic en Screeb API.
- En Clave de API del workspace, haz clic en Copiar.
- Entrega la clave al desarrollador que configura la integración por un canal seguro, como tu gestor de contraseñas.

La clave no es el ID del Workspace que aparece en el código de instalación de tu sitio o app. Ese ID es público y solo identifica el Workspace ante el tag y los SDK, consulta Instalar Screeb en tu sitio web o aplicación web.
Usar la clave
Sección titulada «Usar la clave»Tus desarrolladores la envían en la cabecera Authorization: Bearer de cada petición a la Screeb API. Con ella pueden:
- Enviar datos de usuario desde tu backend: propiedades de usuario, eventos, grupos, vistas de página y de pantalla. Consulta Enviar y gestionar propiedades de usuario y Registrar y gestionar eventos de usuario.
- Registrar Releases desde tu pipeline de despliegue, consulta Haz seguimiento de tus Releases.
Los endpoints, los payloads y los límites están en la referencia de la Screeb API.
Algunas integraciones muestran su propio token en su página. Ese token es independiente de la clave API del Workspace.
Restablecer la clave
Sección titulada «Restablecer la clave»Restablece la clave cuando se haya filtrado o cuando alguien que la conocía deje tu equipo.
- Abre Releases y haz clic en Crear releases vía API. La ventana muestra la misma clave, con un botón de copia para los editores y administradores del Workspace.
- Haz clic en Restablecer y luego en Restablecer token. La nueva clave sustituye a la anterior de inmediato. Solo los administradores de la organización ven Restablecer.
- Entrega la nueva clave a tus desarrolladores y actualiza todos los servidores, scripts y pipelines que usaban la anterior.
Restablecer la clave no se puede deshacer. Todas las llamadas que sigan usando la clave anterior fallarán con un error de autorización hasta que usen la nueva, tanto para datos de usuario como para Releases.
Qué obtienes
Sección titulada «Qué obtienes»Tu backend puede enviar datos y Releases a Screeb, y sabes dónde rotar la clave cuando haga falta.
Solución de problemas
Sección titulada «Solución de problemas»La API responde 401 Unauthorized. La clave falta, está mal escrita o se restableció. Cópiala de nuevo desde Screeb API y comprueba que la cabecera sea Authorization: Bearer seguida de la clave.
Los datos llegan al Workspace equivocado. Cada Workspace tiene su propia clave. Comprueba que has copiado la clave del Workspace que estás viendo.