Đây là gì?
API Đối tác COROS cung cấp quyền truy cập lập trình toàn diện cho các nền tảng đã được xác lập. Điều này bao gồm thông tin xác thực OAuth đa người dùng, thông báo đẩy qua webhook, đồng bộ dữ liệu hai chiều, nhập/xuất cung đường GPX và hỗ trợ tích hợp quy mô doanh nghiệp.
Yêu cầu
- Nền tảng đã xác lập với lượng người dùng đã được chứng minh
- Công ty đã đăng ký với đại diện kỹ thuật được ủy quyền
- Tuân thủ tiêu chuẩn bảo mật và quyền riêng tư dữ liệu
- Đồng ý với Điều khoản Sử dụng API COROS
Bạn nhận được gì
- Thông tin xác thực OAuth 2.0 đa người dùng (phục vụ toàn bộ người dùng của bạn)
- Thông báo đẩy qua webhook (dữ liệu tập luyện được đẩy đến endpoint của bạn trong khoảng ~5 phút)
- Đồng bộ dữ liệu hoạt động hai chiều
- Đồng bộ tập luyện và kế hoạch tập luyện có cấu trúc (đẩy đến người dùng COROS)
- Nhập/xuất cung đường GPX (tối đa 50MB)
- Truy cập dữ liệu sức khỏe hàng ngày
- Tải xuống tệp FIT
- Giới hạn tốc độ: 1.000 lần gọi/phút
Quy trình đăng ký
- Gửi thông tin kỹ thuật. Đại diện kỹ thuật được ủy quyền gửi thông tin công ty, liên hệ kỹ thuật và các URI chuyển hướng OAuth 2.0.
- Xem xét và chấp nhận điều khoản tiêu chuẩn. Đồng ý với Điều khoản Sử dụng API tiêu chuẩn, không phân biệt đối xử của chúng tôi, bao gồm các yêu cầu bảo mật tiêu chuẩn, tuân thủ quyền riêng tư dữ liệu và giới hạn tốc độ hệ thống.
- Nhận thông tin xác thực API. Sau khi xác minh danh tính và thông số bảo mật của bạn, đội ngũ của chúng tôi sẽ cấp ID Khách hàng API và Secret để kích hoạt truyền dữ liệu tự động.
Để bắt đầu quy trình này, hãy gửi thông tin nền tảng của bạn đến api@coros.com và đăng ký bằng biểu mẫu đăng ký.
Tham khảo API
| Danh mục Endpoint | Chức năng |
| Auth | OAuth 2.0 (ủy quyền, access token, làm mới, hủy ủy quyền, bind state) |
| Dữ liệu người dùng | getUserInfo, getWorkoutRecords (tối đa 30 ngày, truy xuất 3 tháng), getDailyData |
| Chi tiết tập luyện | getWorkoutDetailFit (tải xuống tệp FIT) |
| Push / Webhooks | Đẩy tóm tắt tập luyện (~5 phút, logic thử lại), client_id/secret trong header |
| Kế hoạch tập luyện | tp/list/push, tp/workout/deleteById |
| Số tuyến | route/push (GPX/KML, tối đa 50MB) |
| Tải lên tập luyện | file/synchronous, file/upload (không đồng bộ), file/upload/get (trạng thái) |
Chưa đủ quy mô?
Nếu bạn chưa đáp ứng yêu cầu truy cập API Đối tác, bạn có thể xây dựng trên COROS bằng MCP với OAuth 2.0 (Xây dựng trên COROS MCP). Tự phục vụ, không cần đăng ký. Khi nền tảng của bạn phát triển, bạn có thể đăng ký truy cập đầy đủ API Đối tác.