Strandposten API

Endpoint

Authenticatie

De basisgegevens van strandposten kunnen zonder authenticatie worden opgehaald.

Voor het ophalen van aanvullende weerdata is authenticatie vereist via een Application Password.

HTTP Basic Authentication

Gebruik de gebruikersnaam en het bijbehorende Application Password via HTTP Basic Authentication.

curl \
  --user "api-gebruiker:xxxx xxxx xxxx xxxx xxxx xxxx" \
  "https://dashboard.staging.strand-app.nl/api/beachposts/v1/overview?municipality=schouwen-duiveland"

Application Passwords worden afzonderlijk per API-gebruiker aangemaakt en kunnen ook afzonderlijk worden ingetrokken.

Query parameters

Response structuur

Strandpost object

De weerdata is gebaseerd op de kustverwachting van Buienradar. Voor iedere strandpost wordt op basis van de provincie de bijbehorende kustregio bepaald.

De beschikbare kustregio's zijn: Noord-Holland, Zuid-Holland, Zeeland en Waddeneilanden.

Weather day object

Voorbeeld response zonder authenticatie

{
  "getstrandposten": "success",
  "strandposten": [
    {
      "id": 93,
      "external_id": 101,
      "name": "Hoofdpost Noord (Scheveningen)",
      "description": "",
      "phone": "",
      "lat": 52.1085111,
      "lng": 4.2714783,
      "municipality": {
        "id": 25,
        "name": "Den Haag",
        "slug": "den-haag"
      },
      "province": {
        "id": 8,
        "name": "Zuid-Holland",
        "slug": "zuid-holland"
      },
      "flag": "gele-vlag",
      "flag_color": "FFD628",
      "flag_img": "https://strand-app.nl/assets/flags/HSV_Vlag_Geel-small.jpg",
      "flag_img_no_text": "https://strand-app.nl/assets/flags/hsv-vlag-geel-notext.png",
      "flag_status": true,
      "flag_text": "Pas op met zwemmen! Gevaarlijk",
      "flag_extended_text": "Let op: De lifeguards hebben de gele waarschuwingsvlag gehesen...",
      "state": "Let op! Geen toezicht, lifeguards niet aanwezig.",
      "state_color": "FFF101",
      "state_status": false,
      "status_alarm_team": false,
      "marker_icon": "https://strand-app.nl/assets/img/markers/marker-closed.png",
      "state_icon": "https://strand-app.nl/assets/picto/picto-yellow-flag.svg",
      "state_text": "Let op! Geen toezicht, lifeguards niet aanwezig.",
      "state_img": "https://www.strand-app.nl/assets/img/strandpost-gesloten-v3.png"
    }
  ]
}

Voorbeeld response met authenticatie

Bij een geauthenticeerde request wordt per strandpost aanvullend het veld weather toegevoegd.

{
  "getstrandposten": "success",
  "strandposten": [
    {
      "id": 120,
      "external_id": 245,
      "name": "Strandpost Renesse",
      "lat": 51.7321,
      "lng": 3.7684,
      "municipality": {
        "id": 34,
        "name": "Schouwen-Duiveland",
        "slug": "schouwen-duiveland"
      },
      "province": {
        "id": 6,
        "name": "Zeeland",
        "slug": "zeeland"
      },

      "weather": {
        "region": "Zeeland",
        "days": [
          {
            "date": "2026-08-11",

            "temperature": {
              "min": 20.1,
              "max": 24.8
            },

            "icon_code": "a",

            "wind": {
              "speed_ms": 6.0,
              "direction_degrees": 70,
              "direction": "O",
              "beaufort": 4
            },

            "precipitation": 0.0,
            "uv_index": 6,

            "wave": {
              "height": 0.59,
              "direction_degrees": 0
            },

            "sea_water_temperature": 21.25,

            "tides": {
              "low": [
                "07:28",
                "19:58"
              ],
              "high": [
                "01:00",
                "13:31"
              ]
            },

            "warnings": {
              "jellyfish": false,
              "floating_devices": false,
              "dangerous_sea": false,
              "rip_current": true
            }
          },

          {
            "date": "2026-08-12",

            "temperature": {
              "min": 15.2,
              "max": 29.5
            },

            "icon_code": "a",

            "wind": {
              "speed_ms": 4.8,
              "direction_degrees": 85,
              "direction": "O",
              "beaufort": 3
            },

            "precipitation": 0.0,
            "uv_index": 6,

            "wave": {
              "height": 0.66,
              "direction_degrees": 90
            },

            "sea_water_temperature": 20.8,

            "tides": {
              "low": [
                "08:18",
                "20:47"
              ],
              "high": [
                "01:54",
                "14:19"
              ]
            },

            "warnings": {
              "jellyfish": false,
              "floating_devices": false,
              "dangerous_sea": false,
              "rip_current": true
            }
          },

          {
            "date": "2026-08-13",

            "temperature": {
              "min": 18.4,
              "max": 32.8
            },

            "icon_code": "a",

            "wind": {
              "speed_ms": 2.8,
              "direction_degrees": 103,
              "direction": "O",
              "beaufort": 2
            },

            "precipitation": 0.0,
            "uv_index": 6,

            "wave": {
              "height": 0.35,
              "direction_degrees": 90
            },

            "sea_water_temperature": 20.88,

            "tides": {
              "low": [
                "09:03",
                "21:32"
              ],
              "high": [
                "02:41",
                "15:03"
              ]
            },

            "warnings": {
              "jellyfish": false,
              "floating_devices": false,
              "dangerous_sea": false,
              "rip_current": false
            }
          }
        ]
      }
    }
  ]
}

Voorbeeld gebruik JavaScript

Voor publieke strandpostdata kan een normale fetch() worden gebruikt.

fetch('https://dashboard.staging.strand-app.nl/api/beachposts/v1/overview?municipality=schouwen-duiveland')
  .then(response => response.json())
  .then(data => {

    if (data.getstrandposten !== 'success') {
      return;
    }

    data.strandposten.forEach(post => {
      console.log(
        post.name,
        post.lat,
        post.lng,
        post.state_status
      );
    });

  });

Weather data verwerken

data.strandposten.forEach(post => {

  if (!post.weather) {
    return;
  }

  const today = post.weather.days.find(day => {
    return day.date === new Date().toISOString().slice(0, 10);
  });

  if (!today) {
    return;
  }

  console.log(
    'Strandpost:',
    post.name
  );

  console.log(
    'Temperatuur:',
    today.temperature.min,
    '-',
    today.temperature.max,
    '°C'
  );

  console.log(
    'Wind:',
    today.wind.direction,
    today.wind.beaufort,
    'Bft'
  );

  console.log(
    'Golfhoogte:',
    today.wave.height,
    'm'
  );

  console.log(
    'Zeewater:',
    today.sea_water_temperature,
    '°C'
  );

  console.log(
    'Muistroming waarschuwing:',
    today.warnings.rip_current
  );

});