Questions fréquentes sur l'API marée
Cette page regroupe les questions qui reviennent le plus fréquemment lorsqu'on découvre ou que l'on commence à intégrer l'API api-maree.fr.
Que renvoie l'API
L'API renvoie des hauteurs d'eau au format JSON, avec une période demandée, un site, une unité et un tableau de points horodatés.
Peut-on l'utiliser dans un site web
Oui. C'est même l'un des cas d'usage les plus naturels. Le JSON peut être affiché dans une table, un graphique ou un composant front-end.
Comment connaître les sites disponibles
L'endpoint /sites permet de récupérer la liste des sites et ports disponibles
sans avoir à la maintenir à la main.
Y a-t-il un quota
Oui, l'API applique un quota horaire par compte ainsi qu'une limite sur le nombre de hauteurs d'eau renvoyées dans une requête.
Pour éviter de rejouer trop de requêtes identiques et d'atteindre cette limite, il est recommandé d'enregistrer les données utiles en local sur votre serveur, puis de les réutiliser tant qu'elles correspondent à votre besoin.
Faut-il être développeur pour l'utiliser
Pas forcément. Le site propose déjà un testeur de requête qui permet de construire une URL, de voir la réponse JSON et d'obtenir un graphique sans écrire de code.