Search the station catalogue

Extraits de code

curl "https://api.oanor.com/buoys-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/buoys-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/buoys-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/buoys-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "type": null,
        "count": 6,
        "limit": 20,
        "query": "hatteras",
        "total": 6,
        "offset": 0,
        "results": [
            {
                "id": "41001",
                "name": "EAST HATTERAS - 150 NM East of Cape Hatteras",
                "type": "3-meter foam buoy",
                "owner": "N",
                "latitude": 34.791,
                "longitude": -72.42
            },
            {
                "id": "41002",
                "name": "SOUTH HATTERAS - 225 NM South of Cape Hatteras",
                "type": "3-meter foam buoy",
                "owner": "N",
                "latitude": 31.743,
                "longitude": -74.955
            },
            {
                "id": "41062",
                "name": "Hatteras Bay (B1)",
                "type": "Buoy",
                "owner": "UB",
                "latitude": 35.778,
                "longitude": -75.095
            },
            {
                "id": "41120",
                "name": "Cape Hatteras East, NC (250)",
                "type": "Waverider Buoy",
                "owner": "R",
                "latitude": 35.258,
                "longitude": -75.285
            },
            {
                "id": "41X01",
                "name": "Adrift from 41001, 150nm E of Cape Hatteras",
                "type": "3-meter foam buoy",
                "owner": "N",
                "latitude": 34.502,
                "longitude": -72.522
            },
            {
                "id": "HCGN7",
                "name": "8654467 - USCG Station Hatteras, NC",
                "type": "Water Level Observation Network",
                "owner": "O",
                "latitude": 35.209,
                "longitude": -75.704
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T05:48:00.142Z",
        "request_id": "bb556165-b174-40d9-afc5-4504741160ae"
    },
    "status": "ok",
    "message": "Stations listed",
    "success": true
}