L'API Les Horaires

Possibilité offertes par l'API

Les-horaires.fr propose une API destinées aux éditeurs et autres webmasters pour leur permettre d'accéder au contenu de notre base de données :

Liste des commerces autour d'un point
Liste des commerces d'une ou plusieurs catégories, par département
Liste des commerces d'une chaine
Liste des chaînes
Liste des catégories
Liste des codes postaux
Liste des villes
Liste des commerces ouverts, de la catégorie vêtements pour femmes, autour d'un point, dans le département XX
Etc...

Activation de l'API

Afin de vous activer un accès à cette API, vous devez nous contacter par e-mail (julien@beyoung.fr) en précisant :

Nom de la société ou votre nom
Votre adresse e-mail
URL du site sur lequel l'API va être utilisée
Usage envisagé de l'API

Conditions d'Utilisation de l'API

Les horaires d'ouverture ne sont pas donnés en clair par l'API, nous ne vous fournissons qu'un tag image que vous pouvez afficher sur votre site ou service.

A chaque fois que vous affichez un commerce sur votre site nous vous demandons d'ajouter un lien retour vers la page du commerce sur Les-horaires.fr (sur le nom du commerce ou sur le tableau d'horaires par exemple).

L'API ne peut vous servir qu'à proposer un outil de recherche et/ou une liste de commerces, la création d'une page par commerce sur votre site n'est pas souhaitée et entrainera la désactivation de votre accès à l'API.

Vous ne devez pas stocker les données retournées par l'API sur vos serveurs sauf dans une logique de "cache" temporaire.

Toute utilisation de l'API entraîne l'acceptation des présentes conditions. Les conditions sont par ailleurs amenées à évoluer et nous nous réservons le droit de suspendre temporairement ou de manière permanente l'accès à tout ou partie des résultats.

Documentation

L'API est accessible à l'adresse suivante :

http://www.les-horaires.fr/api

Paramètres obligatoires

key	Clef d'utilisation de l'API qui vous sera fournie à l'activation
h	Hash de vérification
get	Type de retour. Valeurs possibles : shop(id) : Retourne des information sur un commerce en particulier shops(...) : Retourne une liste de commerces groups : Retourne la liste des enseignes categories : Retourne la liste des catégories du site cities(loc) : Retourne la liste des villes

Api - Get Shop - Détails

Vous permet d'obtenir toutes nos informations sur un commerce précis dont vous connaissez l'identifiant

id	Identifiant du commerce - requis Vous permet de définir l'ID du commerce dont vous voulez les informations

Api - Get Shops - Détails

Au moins l'un des paramètres ou couple de paramètres suivant est requis lorsque vous interrogez l'API pour rechercher des commerces : lat/lng, dep, group, cat

lat	Latitude - requis si vous précisez une longitude Vous permet de définir un point central autour duquel vous recherchez des commerces
lng	Longitude - requis si vous précisez une latitude Vous permet de définir un point central autour duquel vous recherchez des commerces
dep	Numéro du département Vous permet de limiter votre recherche à un département
group	Identifiant de la chaîne Vous permet de limiter votre recherche à une chaîne
cat	Identifiant de catégorie/sous catégorie (Exemple : 3 ; 3_4 ; 5_1 ; 6) Vous permet de limiter votre recherche à une ou plusieurs catégories/sous catégorie. Concatenez les catégories par un pipe (\|) - Exemple : 3\|3_4\|5_1
name	Limite les résultats aux commerces contenant la chaine spécifiée dans leur nom
loc	Rechercher autour d'une localité Accepte un code postal ou le nom d'une ville. Idéalement spécifiez Ville + code postal entre parenthèses. Exemple : Laval (53000)
open	1 : Vous permet de rechercher les commerces ouverts en ce moment 24 : Vous permet de recherche les commerces ouverts 24h/24
distance	1 à 100 : Spécifie le rayon de recherche Requiert la spécification d'une latitude et d'une longitude
order	Valeur possible : distance Requiert la spécification d'une latitude et d'une longitude
offset	0 à 99 : Spécifie l'offset de retour des résultats (Exemple : 5 prendra les RES résultats depuis le 5ème)
res	1 à 100 : Spécifie le nombre de résultats maximum attendu

Api - Get Cities - Détails

Vous permet d'obtenir une liste de villes / codes postaux à partir de la saisie d'un utilisateur

loc	Code postal ou Ville - requis Accepte un code postal ou le nom d'une ville. Idéalement spécifiez Ville + code postal entre parenthèses. Exemple : Laval (53000)

Exemples d'utilisation

Obtenir la liste des chaînes


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=groups

Obtenir la liste des catégories


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=categories

Obtenir les informations d'un commerce en particulier


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=shop&id=1234

Obtenir la liste des commerces autour d'une position GPS


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=shops&lat=48.65&lng=1.25&res=10

Obtenir la liste des villes contenant "Laval"


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=cities&loc=Laval

Obtenir la liste des villes ayant le code postal 33500


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=cities&loc=33500

Obtenir la liste des boulangeries ouvertes dans le département


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=shops&dep=35&open=1&cat=2_4

Obtenir la liste des bureaux de poste ouverts les plus proches autour d'une position GPS


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=shops&group=9&open=1&lat=48.65&lng=1.25&order=distance

Obtenir la liste des magasins pour femmes et mixtes les plus proches d'une position GPS dans le département


http://www.les-horaires.fr/api?key=VOTRE_CLEF&h=VOTRE_HASH&get=shops&dep=35&cat=10_1|10_3&lat=48.08&lng=-1.68&order=distance

Note sur les données retournées par l'API

Les données retournées sont issues de notre base de données, elles sont donc fournies à titre indicatif et ne peuvent être considérées comme exhaustives ou exactes.

E-mail
Mot de passe