Skitour :: API

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"}