Envoi de trace par un tiers

POST /v1/track_upload

Envoyez un fichier de trace directement, sans authentification utilisateur, à l'aide d'une clé d'envoi.

Ce point d'accès est conçu pour les applications tierces qui envoient des traces au nom des utilisateurs.

En-têtes requis :

• X-STL-Upload-key — clé d'envoi unique de l'utilisateur (générée dans les préférences utilisateur)
• X-STL-Secret-Key — clé secrète de votre application, fournie par SportsTrackLive

Paramètres requis :

• track[category_id] — identifiant de catégorie (par ex. 1 pour le parapente). Obligatoire
• track[imported_file] — fichier de trace au format GPX ou IGC. Obligatoire

Paramètres optionnels :

• track[track_type] — type de trace : "classic_track" (par défaut) ou "live_track"
• track[time_zone] — fuseau horaire (par ex. "Europe/Paris", par défaut "UTC")

La trace est automatiquement placée en file d'attente pour analyse après l'envoi.

Requête

Curl

curl -X POST -H "X-STL-Upload-key: {{upload_key}}" -H "X-STL-Secret-Key: {{secret_key}}" \
  --form 'track[track_type]="classic_track"' \
  --form 'track[category_id]="1"' \
  --form 'track[time_zone]="Europe/Paris"' \
  --form 'track[imported_file]=@"/path/to/your/file.igc"' \
  "https://api.sportstracklive.com/v1/track_upload"

HTTP

POST /v1/track_upload HTTP/1.1
Host: api.sportstracklive.com
Content-Type: multipart/form-data
X-STL-Upload-key: {{upload_key}}
X-STL-Secret-Key: {{secret_key}}

track[track_type]=classic_track
track[category_id]=7
track[time_zone]=Europe/Paris
track[imported_file]=@file.igc

Réponse en cas de succès

200 OK — application/json; charset=utf-8

{
    "success": true,
    "track_id": 1312923,
    "status": "status_imported"
}

Réponse en cas d'erreur

401 Unauthorized — application/json; charset=utf-8

{
    "code": "invalid_upload_key",
    "error": "Invalid or missing upload key"
}