API Skitour
L'API vous permet d'effectuer des requêtes sur la base topos/sorties de Skitour pour alimenter votre propre application. Chaque requête doit être signée dans le header avec un paramètre "cle" à récupérer depuis la page de modification de votre profil.
Conditions d'utilisation de l'API
- L'utilisation de l'API est ouverte à toutes les applications, qu'elles soient commerciales ou non.
- Une application = une clé. Le nombre de transactions est limité à 1000 pour 24 heures et 60 par minute. Vous avez plus de besoins ? merci de nous contacter. Vos statistiques de consommation sont disponibles sur la page stats.
- Les données sur skitour sont sous licence CC by-sa 4.0 (Données collaboratives du topoguide) et CC-by-nc-nd 4.0 (Données personnelles = sorties textes et photos). Vous pouvez les utiliser dans le respect de la licence, de façon brute ou compliée.
- Chaque page qui présente des données issues de l'API (qu'elles soient brutes ou compilées) doit fournir un lien vers la ressource liée sur skitour.fr (ou directement vers l'index dans le cas de données compilées) et citer l'auteur le cas échéant. L'utilisation de photos hors contexte est soumise à autorisation préalable de l'auteur.
Besoin d'aide ? Besoins particuliers ? Merci de nous contacter !
GET
/api/massifs
Récupère la liste des massifs
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/massifs"
Réponse :
JSON exemple
Massifs ou
JSON {"ERROR":"type"}
GET
/api/sommets
Récupère une liste de sommets
Paramètres (facultatifs) :
- m -> liste d'id massif, sous la forme x,y,z
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/sommets?m=1,2,3"
Réponse :
JSON exemple
Sommets ou
JSON {"ERROR":"type"}
GET
/api/departs
Récupère une liste de départs
Paramètres (facultatifs) :
- m -> liste d'id massif, sous la forme x,y,z
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/departs?m=1,2,3"
Réponse :
JSON exemple
Départs ou
JSON {"ERROR":"type"}
GET
/api/refuges
Récupère une liste de refuges
Paramètres (facultatifs) :
- m -> liste d'id massif, sous la forme x,y,z
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/refuges?m=1,2,3"
Réponse :
JSON exemple
Refuges ou
JSON {"ERROR":"type"}
GET
/api/topos
Récupère une liste de topos
Paramètres (facultatifs) :
- m -> id_massif (recherche les topos liés au massif)
- ll -> lat,lon (recherche les topos proche de la position lat,lon fournie)
- s -> id_sommet (recherche les topos liés au sommet)
- d -> id_depart (recherche les topos liés au départ)
- r -> id_refuge (recherche les topos liés au refuge)
Si aucun paramètre n'est fourni, la requête retournera 100 topos par ordre décroissant, selon la page demandée (paramètre p)
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/topos?m=1&ll=45.5,7.1"
Réponse :
JSON exemple
Topos ou
JSON {"ERROR":"type"}
GET
/api/topo/{id}
Récupère le topo {id}
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/topo/125"
Réponse :
JSON exemple
Topo ou
JSON {"ERROR":"type"}
GET
/api/sorties
Récupère une liste de sorties, triées par date DESC
Paramètres (facultatifs) :
- a -> saison (ex : a=2023 retournera les sorties liées à la saison 2022/2023 qui court du 1er sept 2022 au 31 aout 2023)
- f -> from id = sorties postérieures à l'id fourni (ex : f=14750 retournera les sorties les plus récentes, en s'arrêtant à la sortie 14751)
- m -> id_massif
- ll -> lat,lon (recherche autour de la position lat,lon)
- s -> id_sommet
- d -> id_depart
- t -> id_topo
- k -> dif_ski (k=1 à k=5)
- o -> orientation (o=N recherche entre NE et NO, o=NE recherche entre N et E, etc...)
- g -> fichier GPX associé (g=1)
- u -> id auteur ou id participant
- c -> affiche les détails de la sortie dans le flux (sommets et topos liés, conditions, photos) (c=1)
- l -> nombre maximum de résultats retournés, 100 par défaut, 1000 maximum
- p -> numéro de page, 1 par défaut
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/sorties?c=1&a=2022&k=5"
Réponse :
JSON exemple
Sorties ou
JSON {"ERROR":"type"}
GET
/api/sortie/{id}
Récupère la sortie {id} et les conditions liées
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/sortie/571"
Réponse :
JSON exemple
Sortie ou
JSON {"ERROR":"type"}
GET
/api/conditions
Récupère une liste de conditions, par défaut depuis un mois
Paramètres (facultatifs) :
- a -> mois (04.2022 = avril 2022)
- m -> id_massif
- ll -> lat,lon (recherche autour de la position lat,lon)
- s -> id_sommet
- d -> id_depart
- t -> id_topo
- k -> dif_ski (1 à 5)
- o -> orientation (N recherche entre NE et NO, NE recherche entre N et E, etc...)
- u -> id auteur ou id participant
Exemple cURL :
curl -X GET -H "cle: yYOlbMcps8rOuUCdVDTwbawLXO26IHLM" "https://skitour.fr/api/conditions?a=04.2022&o=N"
Réponse :
JSON exemple
Conditions ou
JSON {"ERROR":"type"}