Search by name with country / harbor-size / water-body filters

Frammenti di codice

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

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

$ch = curl_init("https://api.oanor.com/seaports-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/seaports-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "count": 20,
        "limit": 20,
        "query": null,
        "total": 52,
        "offset": 0,
        "filters": {
            "country": "spain",
            "water_body": null,
            "harbor_size": null
        },
        "results": [
            {
                "id": "38420",
                "name": "Hornillo",
                "country": "Spain",
                "latitude": 37.4,
                "longitude": -1.55,
                "un_locode": null,
                "water_body": "Mediterranean Sea; North Atlantic Ocean",
                "harbor_size": "Very Small",
                "harbor_type": "Coastal (Natural)"
            },
            {
                "id": "37770",
                "name": "La Coruna",
                "country": "Spain",
                "latitude": 43.36667,
                "longitude": -8.4,
                "un_locode": "ES LCG",
                "water_body": "North Atlantic Ocean",
                "harbor_size": "Small",
                "harbor_type": "Coastal (Natural)"
            },
            {
                "id": "38440",
                "name": "Alicante",
                "country": "Spain",
                "latitude": 38.33333,
                "longitude": -0.48333,
                "un_locode": "ES ALC",
                "water_body": "Mediterranean Sea; North Atlantic Ocean",
                "harbor_size": "Medium",
                "harbor_type": "Coastal (Breakwater)"
            },
            {
                "id": "45730",
                "name": "Ceuta",
                "country": "Spain",
                "latitude": 35.9,
                "longitude": -5.31667,
                "un_locode": "ES CEU",
                "water_body": "Strait of Gibraltar; North Atlantic Ocean",
                "harbor_size": "Medium",
                "harbor_type": "Coastal (Breakwater)"
            },
            {
                "id": "38290",
                "name": "Cadiz",
                "country": "Spain",
                "latitude": 36.53333,
                "longitude": -6.3,
                "un_locode": "ES CAD",
                "water_body": "North Atlantic Ocean",
                "harbor_size": "Medium",
                "harbor_type": "Coastal (Breakwater)"
            },
            {
                "id": "38220",
                "name": "Huelva",
                "country": "Spain",
                "latitude": 37.25,
                "longitude": -6.95,
                "un_locode": "ES HUV",
                "water_body": "North Atlantic Ocean",
                "harbor_size": "Medium",
                "harbor_type": "River (Natural)"
            },
            {
                "id": "37740",
                "name": "Ferrol",
                "country": "Spain",
                "latitude": 43.48333,
                "longitude": -8.23333,
                "un_locode": "ES FRO",
                "water_body": "North Atlantic Ocean",
                "harbor_size": "Medium",
     
…