Cómo usar la API y los tokens de acceso
La API de Rabbiit deja que otro sistema consulte y grabe datos de la cuenta — informes, registros, proyectos — en nombre de un usuario. Cada integración usa un token de acceso. Quien tiene el token opera con el mismo nivel de permiso de esa persona.
Esto es distinto de un webhook: la API la llamas cuando la necesitas; el webhook lo dispara Rabbiit solo cuando ocurre el evento.
💡 Plan: el panel de Integraciones (consumo, tokens de la cuenta y permiso de creación) forma parte de Ultimate. Cada plan tiene un límite diario de solicitudes. La documentación de los endpoints está en api-docs.rabbiit.com.
Para quién es
Pantalla de tokens personales de la API
Administrador — sigue el consumo, define quién puede crear token y revoca el acceso cuando alguien sale o un proveedor deja de prestar el servicio.
Quien integra (admin, superusuario o miembro, según la configuración) — genera su propio token en Mis tokens y lo guarda en la bóveda de la integración.
Colaborador sin permiso de token — no crea clave. Sigue solo registrando horas.
Dónde encontrarlo
Hay dos pantallas:
- Configuración > Integraciones — el administrador ve el uso de la API, quién puede crear tokens y la lista de tokens de la cuenta.
- Tú > Mis tokens — cada persona autorizada crea y revoca sus tokens.
Las dos conviven: la creación es personal; la vista de la cuenta es del administrador.
Gestión de la API
Gestión de la API con el consumo diario de solicitudes
En Configuración > Integraciones, pestaña Gestión de la API:
- Uso diario de la API — barra de progreso con cuántas solicitudes ya se hicieron y cuántas quedan.
- El límite es compartido entre todos los tokens de la cuenta. No es un techo por persona.
- El panel muestra cuándo el límite se renueva.
- Hay límite. Si la cuenta llega al techo del plan, las llamadas pasan a rechazarse hasta la renovación — o hasta un upgrade.
En la misma pestaña el administrador define quién puede crear tokens personales:
- Solo administradores
- Administradores y superusuarios
- Todos los miembros
Solo el administrador cambia esa configuración. Quien no está en el grupo elegido no ve Mis tokens (o no puede crear).
Mis tokens
Cada persona autorizada abre Tú > Mis tokens y crea sus propias claves.
- Haz clic en Nuevo token.
- Pon un nombre que identifique el destino (“ERP del cliente X”, “Script de informe”).
- Al crear, el valor del token aparece una vez. Cópialo y guárdalo en la bóveda de la integración; no vuelve a mostrarse entero.
- Quien tenga el token tiene el mismo acceso de tu usuario en la API. No compartas la misma clave con todo el mundo — un token por integración.
- Revoca en cuanto el acceso ya no sea necesario (el proyecto terminó, la herramienta cambió, saliste de esa operación).
En la lista aparecen nombre, final del token (para cotejar con lo que guardaste), fecha de creación y último acceso.
Tokens de la cuenta (administrador)
En Configuración > Integraciones, pestaña Tokens de la cuenta, el administrador ve los tokens personales activos de cada persona: propietario, nombre, final del token, creación y último acceso.
Desde ahí se puede revocar el token de cualquiera. La integración que usaba esa clave deja de autenticar al momento. Úsalo cuando la persona salió, un proveedor cerró o una clave se filtró.
El administrador no crea el token “por” la otra persona en esta pestaña — cada uno genera el suyo en Mis tokens. Aquí la función es visibilidad y revocación.
Cuándo usar la API (y cuándo el webhook)
Usa la API cuando el otro sistema tira un informe, sincroniza un catálogo o graba un registro bajo demanda.
Usa webhook cuando el otro sistema necesita reaccionar en el momento del evento (hora registrada, semana aprobada, proyecto creado).
Si la cuenta no integra con nada, ignora estas pantallas. Los informes y el timesheet cubren el día a día sin token.