- L'API est disponible à cette adresse: [http://51.91.251.0:3000](http://51.91.251.0:3000)
- Un tutoriel est disponible ici: [https://www.kaggle.com/maxhalford/tutoriel-d-fi-ia-2023](https://www.kaggle.com/maxhalford/tutoriel-d-fi-ia-2023)

L'aspect particulier de ce concours est qu'il n'y a pas de jeu d'entraînement! A la place, vous avez accès à une API. Celle-ci vous donnera une liste d'hôtels et de prix en réponse à une requête émise.

Afin d'alléger le volume des retours faits par l'API, les caractéristiques des hôtels vous sont fournies dans un fichier séparé (features_hotels.csv dans l'onglet ["Data"](https://www.kaggle.com/competitions/defi-ia-2023/data?select=features_hotels.csv)).

Pour pouvoir accéder à l'API, vous devez avoir un compte. Envoyez un mail à [maxhalford25@gmail.com](mailto:maxhalford25@gmail.com) pour en créer un. Vous avez le droit à un seul compte par équipe. Indiquez donc votre nom d'équipe dans le mail, et l'université/école/parcours dont vous faites partis. Nous vous enverrons une clé utilisateur. Vous pourrez incorporer celle-ci à vos requêtes pour vous authentifier.

Vous avez le droit d'émettre **1000 requêtes tous les 7 jours**. Concrètement, lorsque vous faites une requête, nous comptons le nombre de requêtes que vous avez fait sur les 7 derniers jours. Si ce nombre est au-dessus de 1000, nous refusons la requête.

Votre but est donc de construire un jeu de données d'entraînement de plus en plus volumineux. A vous d'être pertinent dans vos choix de paramètres.

Si vous rencontrez des soucis, n'hésitez pas à nous le faire savoir via [l'onglet dédié aux discussions](https://www.kaggle.com/competitions/defi-ia-2023/discussion). Il vaut mieux poser une question en public pour que tout le monde profite de la réponse. Et n'hésitez pas à échanger avec d'autres équipes, tant que vous ne partagez pas vos données!

## Description de l'API

- `city` : Nom de la ville où effectuer la recherche d’hôtels. Valeurs : ‘amsterdam’, ‘copenhagen’, ‘madrid’, ‘paris’, ‘rome’, ‘sofia’, ‘valletta’, ‘vienna’ et ‘vilnius’.
- `date` : Nombre de jours entre la date de la requête et le jour requêté (i.e. le nombre de jour entre le moment où vous regardez sur le site et le jour du check-in). Valeurs : Nombres positifs (entre 44 et 0).
- `language` : Langue de l’interface. Valeurs : ‘austrian’, ‘belgian’, ‘bulgarian’, ‘croatian’, ‘cypriot’, ‘czech’, ‘danish’, ‘dutch’, ‘estonian’, ‘finnish’, ‘french’, ‘german’, ‘greek’, ‘hungarian’, ‘irish’, ‘italian’, ‘latvian’, ‘lithuanian’, ‘luxembourgish’, ‘maltese’, ‘polish’, ‘portuguese’, ‘romanian’, ‘slovakian’, ‘slovene’, ‘spanish’ or ‘swedish’.
- `mobile` : Paramètre permettant de simuler une requête réalisée depuis un téléphone portable (au lieu d’un ordinateur). Valeurs : 1 (téléphone) ou 0 (ordinateur).
- `avatar` : Identifiant d’un utilisateur fictif (e.g. un faux compte client créé).

Chaque réponse de l'API sera composée de:

- La liste des hôtels présents, comprenant pour chaque hôtel retourné 3 valeurs : l'ID de l'hôtel, le prix, le nombre de chambres restantes.
- Un dictionnaire de certaines caractéristiques liées à la requête (vous pouvez aussi stocker vous-même les requêtes que vous faites et ignorer cette partie).