Qu'est-ce que c'est ?
L'API Partenaire COROS offre un accès programmatique complet pour les plateformes établies. Cela inclut des identifiants OAuth multi-utilisateurs, des notifications push via webhook, une synchronisation bidirectionnelle des données, l'import/export de voies GPX et un support d'intégration à l'échelle entreprise.
Exigences
- Plateforme établie avec une base d'utilisateurs démontrée
- Entreprise enregistrée avec représentant technique autorisé
- Conformité standard en matière de sécurité et de confidentialité des données
- Acceptation des Conditions d'utilisation de l'API COROS
Ce que tu obtiens
- Identifiants OAuth 2.0 multi-utilisateurs (pour servir toute ta base d'utilisateurs)
- Notifications push via webhook (données de séance envoyées à ton endpoint en ~5 minutes)
- Synchronisation bidirectionnelle des données d'activité
- Synchronisation des séances structurées et des plans d'entraînement (push vers les utilisateurs COROS)
- Import/export de voies GPX (jusqu'à 50 Mo)
- Accès aux données de santé quotidiennes
- Téléchargements de fichiers FIT
- Limite de débit : 1 000 appels/minute
Processus de candidature
- Soumets les détails techniques. Fais soumettre par un représentant technique autorisé les informations de ton entreprise, les contacts techniques et les URI de redirection OAuth 2.0.
- Examine et accepte les conditions standard. Accepte nos Conditions d'utilisation de l'API, qui incluent les exigences de sécurité standard, la conformité à la confidentialité des données et les limites de débit du système.
- Reçois les identifiants API. Une fois ton identité et les spécifications de sécurité vérifiées, notre équipe t'attribuera ton Client ID et Secret API pour permettre les transferts de données automatisés.
Pour commencer ce processus, envoie les détails de ta plateforme à api@coros.com et postule via le formulaire de candidature.
Référence API
| Catégorie d'endpoint | Fonctions |
| Auth | OAuth 2.0 (autoriser, access token, rafraîchir, désautoriser, bind state) |
| Données utilisateur | getUserInfo, getWorkoutRecords (30 jours max, historique 3 mois), getDailyData |
| Détail séance | getWorkoutDetailFit (téléchargement fichier FIT) |
| Push / Webhooks | Push résumé séance (~5 min, logique de réessai), client_id/secret dans l'en-tête |
| Plans d'entraînement | tp/list/push, tp/workout/deleteById |
| Voies | route/push (GPX/KML, 50 Mo max) |
| Upload séance | file/synchronous, file/upload (async), file/upload/get (statut) |
Pas encore à l'échelle ?
Si tu ne remplis pas encore les conditions pour accéder à l'API Partenaire, tu peux développer sur COROS en utilisant le MCP avec OAuth 2.0 (Développe sur COROS MCP). Libre-service, aucune candidature requise. Quand ta plateforme grandit, tu pourras demander l'accès complet à l'API Partenaire.