Réseaux officiels, une API
Candhis, Météo France, NOAA/NDBC, Sofar Ocean, Vegagerðin et d'autres réseaux actifs alimentent la même API.
REST APIDocs en ligne - clés sur invitation
The Buoy API
Données de bouées océaniques en temps réel et historiques pour développeurs. Utilise des endpoints GET en lecture seule pour lister les bouées actives, filtrer par pays ou géographie, récupérer l'historique et produire des séries temporelles.
terminal
$ curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://thesurfkit.com/api/v2/buoys?country=FR&per_page=5"
{
"status": "success",
"data": {
"buoys": [
{
"id": 12,
"name": "Anglet",
"slug": "anglet",
"source": "Candhis",
"last_reading": {
"significient_height": 1.8,
"maximum_height": 2.4,
"period": 9.5,
"direction": 285,
"water_temperature": 14.2,
"time": "2026-03-27T08:00:00Z"
}
}
],
"count": 28
},
"meta": {
"page": 1,
"per_page": 5,
"total_pages": 6
}
}Ce que couvre l'API publiée
La documentation publique se concentre aujourd'hui sur la découverte des bouées, les dernières mesures et l'accès historique.
Champs de mesure
- significient_height
- maximum_height
- period
- direction
- water_temperature
Requêtes et filtres
- country=FR
- bounds={north,south,east,west}
- near=lat,lng + radius
- query=anglet
- recherche nearest par lat/lng
Conventions
- Endpoints GET uniquement
- Authorization: Bearer <api_key>
- {status, data, meta}
- En-têtes X-RateLimit-*
- page / per_page / total_pages
Endpoints de bouées publiés
La référence officielle documente actuellement neuf endpoints GET en lecture seule pour lister, rechercher, localiser et consulter les données de bouées.
| Method | Endpoint |
|---|---|
| GET | /api/v2/buoys |
| GET | /api/v2/buoys/{buoy_id} |
| GET | /api/v2/buoys/last_readings |
| GET | /api/v2/buoys/search |
| GET | /api/v2/buoys/nearest |
| GET | /api/v2/buoys/{buoy_id}/readings |
| GET | /api/v2/buoys/{buoy_id}/readings/search |
| GET | /api/v2/buoys/{buoy_id}/readings/{reading_id} |
| GET | /api/v2/buoys/{buoy_id}/readings/chart |
Une API publique plus simple
La documentation en ligne décrit une API de bouées focalisée, avec des payloads prévisibles et des endpoints publics pour la découverte.
Dernières mesures incluses
GET /buoys renvoie déjà chaque bouée avec son last_reading, ce qui permet d'initialiser un pays ou une région en un seul appel.
Format status/data/meta
Les endpoints list, search, nearest et readings partagent la même enveloppe JSON, ce qui simplifie l'intégration côté client.
Recherche par pays et géographie
Filtre avec country, bounds ou near + radius, ou appelle directement /buoys/nearest pour une recherche par coordonnées.
Historique et séries temporelles
Utilise /readings, /readings/search, /readings/{reading_id} et /readings/chart pour le détail et les séries temporelles.
Docs publiques, auth sur invitation
La référence est publique sur docs.labouee.app. Les appels authentifiés utilisent des clés Bearer, tandis que search et nearest restent publics.
Couverture mondiale des réseaux de bouées
La documentation met en avant des sources officielles comme Candhis, Météo France, NOAA/NDBC, Sofar Ocean, Vegagerðin et d'autres réseaux actifs.
Réseau d'observation
CANDHIS
France
Réseau d'observation
Cefas WaveNet
Royaume-Uni, Irlande
Réseau d'observation
Instituto Hidrográfico
Portugal
Réseau d'observation
ISPRA Rete Ondametrica Nazionale
Italie
Service de prévision
Météo-France
France
Réseau d'observation
NOAA NDBC
États-Unis, Monde
Réseau d'observation
Puertos del Estado
Espagne
Réseau d'observation
Queensland Waves
Australie
Réseau d'observation
SHOA
Chili
Réseau d'observation
Sofar Ocean
Monde
Réseau d'observation
Vegagerðin
Islande
Pour Toute Application de Données de Vagues
Des apps de surf à la recherche océanographique, notre API de données de bouées alimente une large gamme de produits.
Apps de Surf
Alimentez vos checks de conditions avec des données de hauteur de vagues, période de houle et lectures de bouées en temps réel.
Monitoring Côtier
Construisez des outils de monitoring de vagues pour les ports, marinas, ingénierie côtière et opérations offshore.
Recherche Océanographique
Accédez aux lectures historiques de bouées pour les études climatiques, la modélisation de vagues et le machine learning.
IoT & Hardware
Connectez vos appareils aux données de bouées en direct pour l'alerting, l'affichage et l'automatisation.
Questions Fréquentes
La documentation publique cite notamment Candhis, Météo France, NOAA/NDBC, Sofar Ocean, Vegagerðin et d'autres réseaux actifs. Le site conserve un répertoire de sources plus large, tandis que la référence API se concentre sur les endpoints de bouées publiés.
Les requêtes v2 authentifiées utilisent Authorization: Bearer <api_key>. La documentation accepte aussi api_key en query parameter pour les environnements limités, mais recommande l'en-tête Authorization. Les clés API sont actuellement délivrées sur invitation.
Oui. GET /api/v2/buoys/search et GET /api/v2/buoys/nearest ne demandent pas d'authentification et peuvent être testés avant d'obtenir des identifiants.
GET /api/v2/buoys renvoie une liste paginée de bouées et intègre déjà last_reading dans chaque résultat. Tu peux aussi filtrer par country, source, bounds ou near + radius sans faire un second appel pour la dernière mesure.
Oui. Utilise GET /api/v2/buoys/{buoy_id}/readings pour l'historique paginé, /readings/search pour trouver la mesure la plus proche d'une heure cible, et /readings/chart pour des séries prêtes à afficher.
Utilise bounds pour une bounding box, near plus radius pour un filtrage radial, ou /api/v2/buoys/nearest avec lat/lng pour résoudre la bouée active la plus proche. L'endpoint de liste supporte aussi le filtre par pays.
Les endpoints de bouées documentés utilisent une enveloppe JSON cohérente avec status, data et meta. La pagination et les timestamps vivent dans meta, et les réponses authentifiées exposent aussi les en-têtes X-RateLimit-*.
Oui. La documentation officielle vit sur docs.labouee.app avec un quickstart, un guide d'authentification, des guides d'usage et une référence publiée pour les endpoints de bouées.
Le quota par défaut est de 1 000 requêtes par heure. Les réponses exposent X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset, et les 429 incluent retry_after quand le quota est dépassé.
Commence par la documentation publique, teste search ou nearest si tu n'as pas encore d'identifiants, puis demande un accès API lorsque tu es prêt à appeler les endpoints authentifiés.
Docs en ligne - clés sur invitation
Obtenir un accès API
La documentation est publique. Demande tes identifiants quand tu es prêt à appeler les endpoints authentifiés au-delà de la recherche publique et de la bouée la plus proche.