Las claves API definen cómo interactúan sus aplicaciones con RUFUS Cloud API. A cada clave se le puede asignar un tipo de acceso específico, lo que le permite controlar exactamente qué acciones puede realizar una integración.
Esto garantiza una mayor seguridad, una separación más clara de las responsabilidades y unas integraciones más seguras entre dispositivos, aplicaciones y servicios.
Tipos de acceso
| Tipo de acceso | Permisos |
|---|---|
| LEER | Puede llamar a todos los puntos de conexión GET. Permite leer datos como dispositivos, sesiones, pases, eventos y participantes. |
| ESCRIBIR | Puede llamar a los puntos finales POST y PATCH. Permite enviar datos (sesiones, pases, estado/telemetría del dispositivo) y crear participantes. |
| LEER_ESCRIBIR | Acceso completo a todos los puntos de conexión GET, POST y PATCH. |
| Desvincular dispositivo | Propiedad opcional disponible para claves WRITE y READ_WRITE. Permite el acceso a las operaciones DELETE, como desvincular un dispositivo de una cuenta. |
Notas sobre los permisos
- Los informes de telemetría (actualizaciones del estado del dispositivo) requieren acceso de ESCRITURA o superior.
- La creación de participantes está restringida a las claves con permisos de ESCRITURA y está sujeta a los límites del plan y a la validación de la propiedad.
- Las actualizaciones y correcciones de los participantes intencionadamente no están disponibles a través del API público y deben gestionarse a través del RUFUS Race Manager (RRM).
- Las operaciones de ELIMINACIÓN son limitadas y están protegidas, y deben habilitarse explícitamente a través de la propiedad *Desvincular dispositivo*.
Casos de uso típicos
| Alias de clave API | Tipo de acceso | Solicitud |
|---|---|---|
| Dispositivos | ESCRIBIR | Se utiliza en dispositivos RFID o sistemas perimetrales para enviar sesiones, pases y datos de telemetría. |
| Aplicación de cronometraje | LECTURA_ESCRITURA | Se utiliza en software de cronometraje o aplicaciones móviles que envían y consumen datos de cronometraje. |
| Aplicación de clasificación | LEER | Se utiliza en sistemas de resultados o clasificación que solo necesitan leer eventos, participantes y pasadas. |
| Administrador | LECTURA_ESCRITURA + Desvincular | Se utiliza en paneles internos o herramientas de administración con control total, incluida la gestión de dispositivos. |
Este modelo le permite diseñar integraciones que son seguras por defecto, al tiempo que son lo suficientemente flexibles como para cubrir todo, desde la ingesta de dispositivos de bajo nivel hasta los flujos de trabajo completos de gestión de eventos.