Co to jest?
Partner API COROS zapewnia pełny programistyczny dostęp dla uznanych platform. Obejmuje to wieloużytkownikowe poświadczenia OAuth, webhooki z powiadomieniami push, dwukierunkową synchronizację danych, import/eksport tras GPX oraz wsparcie integracji na skalę przedsiębiorstwa.
Wymagania
- Uznana platforma z udokumentowaną bazą użytkowników
- Zarejestrowana firma z upoważnionym przedstawicielem technicznym
- Standardowa zgodność z bezpieczeństwem i prywatnością danych
- Akceptacja Warunków Użytkowania API COROS
Co otrzymujesz
- Wieloużytkownikowe poświadczenia OAuth 2.0 (obsługa całej bazy użytkowników)
- Webhooki z powiadomieniami push (dane treningowe wysyłane do twojego endpointu w ciągu ~5 minut)
- Dwukierunkowa synchronizacja danych aktywności
- Synchronizacja strukturalnych treningów i planów treningowych (wysyłka do użytkowników COROS)
- Import/eksport tras GPX (do 50MB)
- Dostęp do codziennych danych zdrowotnych
- Pobieranie plików FIT
- Limit: 1 000 wywołań/minutę
Proces aplikacji
- Prześlij dane techniczne. Upoważniony przedstawiciel techniczny powinien przesłać dane firmy, kontakty techniczne oraz URI przekierowania OAuth 2.0.
- Przejrzyj i zaakceptuj standardowe warunki. Zaakceptuj nasze standardowe, niedyskryminujące Warunki Użytkowania API, które obejmują wymagania dotyczące bezpieczeństwa, zgodność z prywatnością danych oraz limity systemowe.
- Odbierz poświadczenia API. Po weryfikacji tożsamości i wymagań bezpieczeństwa nasz zespół wyda twój Client ID i Secret API, umożliwiając automatyczne transfery danych.
Aby rozpocząć ten proces, prześlij dane swojej platformy na api@coros.com oraz złóż wniosek przez formularz aplikacyjny.
Dokumentacja API
| Kategoria Endpointu | Funkcje |
| Auth | OAuth 2.0 (autoryzacja, token dostępu, odświeżanie, deautoryzacja, powiązanie stanu) |
| Dane użytkownika | getUserInfo, getWorkoutRecords (30-dniowy max, 3-miesięczny wstecz), getDailyData |
| Szczegóły treningu | getWorkoutDetailFit (pobieranie pliku FIT) |
| Push / Webhooki | Powiadomienie podsumowania treningu (~5 min, logika ponawiania), client_id/secret w nagłówku |
| Plany treningowe | tp/list/push, tp/workout/deleteById |
| Trasy | route/push (GPX/KML, 50MB max) |
| Wgrywanie treningu | file/synchronous, file/upload (asynchronicznie), file/upload/get (status) |
Jeszcze nie na dużą skalę?
Jeśli jeszcze nie spełniasz wymagań dostępu do Partner API, możesz budować na COROS używając MCP z OAuth 2.0 (Buduj na COROS MCP). Samoobsługa, bez konieczności składania wniosku. Gdy twoja platforma się rozwinie, możesz ubiegać się o pełny dostęp do Partner API.