Skip to main content
functionbase

Nationale feestdagen API 100 landen

By juli 25, 2022juli 26th, 2022No Comments

Met de nationale feestdagen API lees je snel de juiste feestdagen voor een specifiek land in een specifiek jaar en, optioneel, ook nog in de taal van het land. De feestdagen voor ruim 100 landen zijn beschikbaar.

Deze API vervangt de oude feestdagen Europa API en de Excel sheet.

Tot 100 requests per jaar is de API gratis te gebruiken. Indien je meer requests uit wil kunnen voeren dan is dat altijd, tegen betaling, mogelijk. Neem hiervoor contact op met Reinder.

Applicatie sleutel

Om gebruik te kunnen maken van een functie in de functionbase heb je een persoonlijke applicatiecode nodig.

Deze vraag je aan middels onderstaande end-point. Op het e-mailadres dat je in het verzoek meegeeft ontvang je de persoonlijke applicatiecode. Controleer ook je ongewenste mail.

GET

https://functionbase.nl/api/v2022/app/register/holiday?emailaddress={Je eigen e-mailadres}&name={Je eigen naam}

Je vervangt dus de tekst, inclusief de accolades, door je eigen emailadres en je eigen naam.

Feestdagen endpoint

Wanneer je een applicatiecode hebt ontvangen dan kan je de API gebruiken. Het eindpoint van de API is :

https://functionbase.nl/api/v2022/publicholiday

Parameters voor het opvragen van de feestdagen

  • appkey = De applicatiesleutel die je in de mail hebt ontvangen (Verplicht)
  • year = Het jaar waarvan je de feestdagen op wilt vragen. (Verplicht)
  • country = Het land (ISO ALPHA 2) waarvan de de feestdagen op wilt vragen. (Verplicht)
  • language = De taal (ISO 639-1) waarin je de feestdagen vertaald wilt ontvangen in de response. (Optioneel)
  • outputformat = Het formaat waarin je de datum en tijd wilt ontvangen in de response. Standaard is dit formaat [dd-MM-yyyy HH:mm tt] (Optioneel)
  • sendmail = Geef deze parameter alleen mee wanneer je de feestdagen ook in Excel wilt ontvangen in je mailbox. De waarde die je in dat geval meegeeft moet altijd 1 zijn wanneer je de mail wilt ontvangen of 0 wanneer je de mail niet wilt ontvangen.

https://functionbase.nl/api/v2022/publicholiday?appkey={Applicatiecode}&year=2021&country=NL

Voorbeeld response nationale feestdagen

{
    “year”: “2021”,
    “country_iso_alpha_2”: “NL”,
    “country_name”: “”,
    “holidays”: [
        {
            “date_id”: 97885,
            “date_base”: “1-1-2021 00:00:00”,
            “culture_info”: “nl-NL”,
            “year_base”: “2021”,
            “quarter_base”: “1”,
            “month_base”: “1”,
            “month_name”: “January”,
            “month_name_local”: “januari”,
            “year_day”: “1”,
            “month_day”: “1”,
            “week_day”: “5”,
            “day_name”: “Friday”,
            “day_name_local”: “vrijdag”,
            “iso_date”: “01/01/2021 00:00:00”,
            “iso_week”: “53”,
            “is_weekend”: false,
            “every_year_on_same_date”: true,
            “global_base”: true,
            “name_base”: “New Year’s Day”,
            “name_local”: “Nieuwjaarsdag”,
            “type”: “Public”,
            “formated_date”: “01-01-2021 00:00 AM”
        },
        {
            “date_id”: 97976,
            “date_base”: “2-4-2021 00:00:00”,
            “culture_info”: “nl-NL”,
            “year_base”: “2021”,
            “quarter_base”: “2”,
            “month_base”: “4”,
            “month_name”: “April”,
            “month_name_local”: “april”,
            “year_day”: “92”,
            “month_day”: “2”,
            “week_day”: “5”,
            “day_name”: “Friday”,
            “day_name_local”: “vrijdag”,
            “iso_date”: “04/02/2021 00:00:00”,
            “iso_week”: “13”,
            “is_weekend”: false,
            “every_year_on_same_date”: false,
            “global_base”: true,
            “name_base”: “Good Friday”,
            “name_local”: “Goede Vrijdag”,
            “type”: “School, Authorities”,
            “formated_date”: “02-04-2021 00:00 AM”
        },…
    ],
    “Result”: “ok”,
    “exception”: null
}

Response velden en hun betekenis

  • date_id= Aantal dagen gerekend vanaf 01-01-1753
  • date_base = Datum in formaat van land
  • culture_info = Code cultuur informatie software
  • year_base =  Jaar van verzoek
  • quarter_base =  kwartaal waarin de feestdag valt
  • month_base =  De maand waarin de feestdag valt
  • month_name = De Engelse benaming voor de maand
  • month_name_local = De benaming van de maand in de gevraagde taal
  • year_day = De dag van het jaar
  • month_day = De dag van de maand
  • week_day = Dag van de week waarbij maandag dag 1 is
  • day_name = De Engelse benaming van de dag
  • day_name_local = De benaming van de dag in de gevraagde taal
  • iso_date = Datum in het ISO formaat
  • iso_week = ISO weeknummer
  • is_weekend = Valt de feestdag in het weekend (boolean)
  • every_year_on_same_date = Valt de feestdag ieder jaar op dezelfde dag
  • global_base = Betreft het een wereldwijde feestdag
  • name_base = De Engelse benaming van de feestdag
  • name_local = De naam van de feestdag in de gevraagde taal
  • type = Type feestdag Openbaar, Bank, School, Autoriteiten, Optioneel
  • formated_date = De datum in het optionele formaat