API VisuGPX
Interrogez les serveurs de VisuGPX depuis votre propre application pour soumettre des fichiers ou récupérer des données ! Tout accès à cet API nécessite un compte VisuGPX et la CLE API liée.
POST
/api/upload
Envoie une trace sur votre compte (membres Premium uniquement)
Headers (* = requis):
- cle* -> clé API du compte premium (vous pouvez la demander ou la renouveller dans la page de modification du profil)
Paramètres (* = requis) :
- gpx* -> le fichier gpx
- name* -> nom de la trace, récupéré dans le fichier si vide
- activity* -> activité (rp: randonnée pédestre, mn: marche nordique, cap: course à pied, tra: trail, vr: cyclotourisme, vtt: VTT, vv: voyage à vélo, vae: vélo à assistance électrique, vte: VTT à assistance électrique, ski: ski de randonnée, srn: ski de randonnée nordique, sf: ski nordique, raq: raquettes à neige, vol: vol libre, vom: vol motorisé, req: randonnée équestre, rol: rollers, vm: auto/moto/quad, km: kayak de mer, na: natation, pv: planche à voile, au: autre)
- desc -> description de la trace
- f -> lissage des altitudes (1: faible, 2: moyen, 3: fort)
- visibility -> Visibilité de la trace sur VisuGPX (0: privée, 1: cachée, 2: publique)
- folder -> numéro de dossier (facultatif, infobulle au survol des dossiers dans votre profil)
- flux -> 1: Ajouter le fichier à votre flux
Exemple cURL :
curl -X POST -H "cle: 617ace176f11786eab7811" -F "gpx=@/path/to/file.gpx" -F "name=Nom de la trace" -F "activity=vtt" "https://www.visugpx.com/api/upload"
Réponse :
id de la trace hébergée ou ERROR: Type
GET
/api/activities
Récupère la liste de vos traces
Headers (* = requis) :
- cle* -> clé API du compte (vous pouvez la demander ou la renouveller dans la page de modification du profil)
Paramètres (facultatifs) :
- folder -> numéro de dossier (facultatif, infobulle au survol des dossiers dans votre profil)
- activity -> activité (rp: randonnée pédestre, mn: marche nordique, cap: course à pied, tra: trail, vr: cyclotourisme, vtt: VTT, vv: voyage à vélo, vae: vélo à assistance électrique, vte: VTT à assistance électrique, ski: ski de randonnée, srn: ski de randonnée nordique, sf: ski nordique, raq: raquettes à neige, vol: vol libre, vom: vol motorisé, req: randonnée équestre, rol: rollers, vm: auto/moto/quad, km: kayak de mer, na: natation, pv: planche à voile, au: autre)
- flux -> 1: récupérer uniquement les traces du flux
Exemple cURL :
curl -X GET -H "cle: 617ace176f11786eab7811" "https://www.visugpx.com/api/activities?activity=vr&flux=1"
Réponse :
Fichier JSON avec les données des traces retournées (id, titre, nom, description, distance, dénivelé, durée, flux, visibility, lat/lng départ, ville départ, date départ) ou ERROR: Type
