¿Qué es esto?
La API de Socios de COROS proporciona acceso programático completo para plataformas establecidas. Esto incluye credenciales OAuth multiusuario, notificaciones push por webhook, sincronización de datos bidireccional, importación/exportación de rutas GPX y soporte de integración a escala empresarial.
Requisitos
- Plataforma establecida con base de usuarios demostrada
- Empresa registrada con representante técnico autorizado
- Cumplimiento estándar de seguridad y privacidad de datos
- Aceptación de los Términos de Uso de la API de COROS
¿Qué obtienes?
- Credenciales OAuth 2.0 multiusuario (sirve a toda tu base de usuarios)
- Notificaciones push por webhook (datos de entrenamiento enviados a tu endpoint en ~5 minutos)
- Sincronización bidireccional de datos de actividad
- Sincronización de entrenamiento estructurado y plan de entrenamiento (envío a usuarios COROS)
- Importación/exportación de rutas GPX (hasta 50MB)
- Acceso a datos de salud diarios
- Descarga de archivos FIT
- Límite de tasa: 1,000 llamadas/minuto
Proceso de solicitud
- Envía los detalles técnicos. Haz que un representante técnico autorizado envíe los datos de tu empresa, contactos técnicos y URIs de redirección OAuth 2.0.
- Revisa y acepta los términos estándar. Acepta nuestros Términos de Uso de la API estándar y no discriminatorios, que incluyen requisitos de seguridad estándar, cumplimiento de privacidad de datos y límites de tasa del sistema.
- Recibe las credenciales de la API. Una vez verificada tu identidad y especificaciones de seguridad, nuestro equipo emitirá tu ID de Cliente y Secreto de API para habilitar transferencias automáticas de datos.
Para iniciar este proceso, envía los detalles de tu plataforma a api@coros.com y solicita usando el formulario de solicitud.
Referencia de la API
| Categoría de Endpoint | Funciones |
| Auth | OAuth 2.0 (autorizar, token de acceso, actualizar, desautorizar, estado de vinculación) |
| Datos de Usuario | getUserInfo, getWorkoutRecords (máximo 30 días, retroceso de 3 meses), getDailyData |
| Detalle de Entrenamiento | getWorkoutDetailFit (descarga de archivo FIT) |
| Push / Webhooks | Resumen de entrenamiento push (~5 min, lógica de reintento), client_id/secret en el encabezado |
| Planes de Entrenamiento | tp/list/push, tp/workout/deleteById |
| Rutas | route/push (GPX/KML, 50MB máx) |
| Carga de Entrenamiento | file/synchronous, file/upload (async), file/upload/get (estado) |
¿Aún no tienes escala?
Si todavía no cumples los requisitos para acceder a la API de Socios, puedes construir sobre COROS usando el MCP con OAuth 2.0 (Construye sobre COROS MCP). Autoservicio, no se requiere solicitud. A medida que tu plataforma crezca, puedes solicitar acceso completo a la API de Socios.