STL Connect & Track upload
Cette documentation est destinée aux partenaires de SportsTrackLive.
SportsTrackLive permet à vos utilisateurs de se connecter et d'envoyer leurs traces.
Notes générales
Toutes les requêtes sont effectuées sur l'URL de base :
https://api.sportstracklive.com/v1Les requêtes et les réponses sont au format JSON, sauf lorsqu'une requête utilise explicitement multipart/form-data pour l'envoi de fichiers.
Authentification
La plupart des points d'accès sont authentifiés à l'aide de deux en-têtes :
| En-tête | Signification |
|---|---|
X-STL-Secret-Key | Une clé unique qui authentifie votre application. Demandez-la à SportsTrackLive. |
X-STL-Token | Un jeton de session par utilisateur renvoyé par Connexion. |
Certaines intégrations utilisent une clé d'envoi plutôt qu'un jeton utilisateur — voir Envoi de trace par un tiers. Les points d'accès des traceurs GPS (JT808, Rapport de position manuel) ne nécessitent aucune authentification.
Détail de l'API
| Point d'accès | Méthode | Chemin |
|---|---|---|
| Connexion | POST | /v1/auth |
| Envoyer une trace | POST | /v1/track |
| Créer une trace en direct | POST | /v1/track |
| Ajouter un ou plusieurs points | PUT | /v1/track/{track_id}/points |
| Terminer le direct | PUT | /v1/track/{track_id}/end_live |
| Envoi de trace par un tiers | POST | /v1/track_upload |
| Message protocole JT808 | POST | /v1/tracker/jt808_message |
| Rapport de position manuel | POST | /v1/tracker/location_report |