Documentation

Tout ce qu'il faut pour integrer les donnees de marees dans votre application.

Authentification

Toutes les requetes necessitent une cle API transmise via le header Authorization.

Authorization: Bearer mk_votre-cle-api

Obtenez votre cle gratuitement sur la page d'accueil. Essai gratuit de 30 jours, 1 000 requetes/mois.

URL de base

https://www.tide-data.com/api/v1

Endpoints

GET/api/v1/tides/{port}

Renvoie les horaires de marees, hauteurs d'eau et coefficient pour un port et une date donnes.

Parametres

Nom	Type	Requis	Description
`port`	string	oui	Identifiant ou nom du port (ex: brest, saint-malo). Voir /api/v1/harbors pour la liste.
`date`	string	non	Date au format YYYY-MM-DD. Par defaut : aujourd'hui.

Exemple

GET https://www.tide-data.com/api/v1/tides/brest?date=2026-03-10

{
  "port": "Brest",
  "date": "2026-03-10",
  "coefficient": 48,
  "tides": [
    {
      "type": "basse_mer",
      "time": "02:55",
      "height_m": 2.49
    },
    {
      "type": "pleine_mer",
      "time": "08:40",
      "height_m": 5.61
    },
    {
      "type": "basse_mer",
      "time": "15:09",
      "height_m": 2.81
    },
    {
      "type": "pleine_mer",
      "time": "21:02",
      "height_m": 5.42
    }
  ]
}

Champs de la reponse

Champ	Type	Description
`port`	string	Nom du port
`date`	string	Date (YYYY-MM-DD)
`coefficient`	number \| null	Coefficient de maree max du jour
`tides`	array	Liste des marees du jour
`type`	string	"pleine_mer" ou "basse_mer"
`time`	string	Heure (HH:MM, heure legale)
`height_m`	number	Hauteur d'eau en metres

GET/api/v1/harbors

Renvoie la liste de tous les ports disponibles avec leurs coordonnees.

Exemple de reponse

GET https://www.tide-data.com/api/v1/harbors

{
  "count": 145,
  "harbors": [
    {
      "id": "BREST",
      "name": "Brest",
      "lat": 48.383,
      "lon": -4.495
    },
    ...
  ]
}

Erreurs

Toutes les erreurs retournent un objet JSON avec un champ error.

Code	Description
`400`	Parametre invalide (ex: format de date incorrect)
`401`	Cle API manquante ou invalide
`403`	Essai gratuit expire
`404`	Port introuvable
`429`	Limite de requetes mensuelle atteinte
`502`	Erreur lors de la recuperation des donnees

Exemple d'erreur

{
  "error": "Port \"xyz\" introuvable. Consultez /api/v1/harbors pour la liste."
}

Demarrage rapide

curl

curl -H "Authorization: Bearer mk_votre-cle-api" \
  https://www.tide-data.com/api/v1/tides/brest

JavaScript / TypeScript

const res = await fetch("https://www.tide-data.com/api/v1/tides/brest", {
  headers: { "Authorization": "Bearer mk_votre-cle-api" }
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://www.tide-data.com/api/v1/tides/brest",
    headers={"Authorization": "Bearer mk_votre-cle-api"}
)
data = res.json()

Limites

Plan	Duree	Requetes/mois
Essai gratuit	30 jours	1 000