Nationale feestdagen API Europa

Api_key en authenticatie

Na registratie ontvang je een, persoonlijke, toegangssleutel. Met deze sleutel heb je toegang tot alle API endpoints waar je op bent geabonneerd. Alle API endpoints benader je met de http GET methode.

https://address.whacky.nl/api/date/holiday?api_key=8ADD9919-E715-414C-B592-137253CE85AA

Met de API_KEY 8ADD9919-E715-414C-B592-137253CE85AA kan je 10 gast verzoeken per maand uitvoeren.

API Endpoints

Voor de Feestdagen Europa API is het endpoint adres : https://address.whacky.nl/api/date/holiday

API Error codes

In alle API endpoints wordt de validatiestatus geretourneerd. De validatiestatus bevat de volgende gegevens:

Validatiecode : Unieke identificatie van de status

Validationinfo : Systeemnaam van de validatie melding

Validationdescription : Detailbeschrijving van de validatie melding

De volgende validatie meldingen kunnen worden geretourneerd:

1001 : ok : Validatie succesvol zonder fouten

1002 : ok_with_warnings : Validatie niet volledig maar wel herkend

1003 : not_valid : Validatie met fouten niet herkend adres

2001 : missing_access_key : De API key ontbreekt in je request

2002 : invalid_access_key : De API key is onjuist

2003 : invalid_api_function : De functie die je aanroept is onjuist. Raadpleeg de documentatie

2004 : usage_limit_reached : Het limiet van je abonnement is bereikt.

2005 : function_access_restricted : Je abonnement staat het verzoek niet toe

4004 : 404_not_found : Je hebt een ongeldig verzoek verzonden dat niet gevonden kan worden

Parameters

Api_key (verplicht) : De persoonlijke toegangssleutel waarmee je toegang krijgt tot de database.

iso_alpha_2_country (verplicht) : De ISO Alpha 2 landcode van het land waar je de feestdagentabel van op wilt vragen. (zie ook lijst onder aan dit document)

iso_alpha_2_language (optioneel) : De ISO Alpha 2 taalcode van het land waar je de feestdagentabel van op wilt vragen. (zie ook lijst onder aan dit document voor de mogelijke combinaties)

year (verplicht) : Het jaar, in format jjjj, waarvan je de feestdagen tabel op wilt vragen.

output_format (Optioneel) : Het formaat waarin je de datum terug wilt kunnen lezen. Standaard is dat het Nederlandse datum en tijd formaat.

https://address.whacky.nl/api/date/holiday?

api_key=8ADD9919-E715-414C-B592-137253CE85AA&

iso_alpha_2_country=NL&

year=2019&

output_format=yyyy-MM-dd%27T%27HH:mm:ss&

iso_alpha_2_language=FY //deze waarde is optioneel (zie ondersteunende landen en talen voor mogelijke opties)

Response feestdagen API

public class Holiday

{

    // Aantal dagen gerekend vanaf 01-01-1753 

    public int date_id { get; set; }

    //Datum in formaat van land

    public string date { get; set; }

    // Unmanaged code cultuur informatie 

    public string culture_info { get; set; }

    // Jaar van verzoek

    public string year { get; set; }

    // kwartaal waarin de feestdag valt

    public string quarter { get; set; }

    // De maand waarin de feestdag valt

    public string month { get; set; }

    // De Engelse benaming voor de maand

    public string month_name { get; set; }

    // De benaming van de maand in de gevraagde taal

    public string month_name_local { get; set; }

    // De dag van het jaar

    public string year_day { get; set; }

   // De dag van de maand

    public string month_day { get; set; }

    // Dag van de week waarbij maandag dag 1 is

    public string week_day { get; set; }

    // De Engelse benaming van de dag

    public string day_name { get; set; }

    // De benaming van de dag in de gevraagde taal

    public string day_name_local { get; set; }

    // Datum in het ISO formaat

    public string iso_date { get; set; }

    // ISO weeknummer

    public string iso_week { get; set; }

    // Valt de feestdag in het weekend

    public bool is_weekend { get; set; }

    // Valt de feestdag ieder jaar op dezelfde dag

    public bool every_year_on_same_date { get; set; }

    // Betreft het een wereldwijde feestdag

    public bool global { get; set; }

    // De Engelse benaming van de feestdag

    public string name { get; set; }

    // De naam van de feestdag in de gevraagde taal

    public string name_local { get; set; }

    // Type feestdag Openbaar, Bank, School, Autoriteiten, Optioneel

    public string type { get; set; }

    // De datum in het optionele formaat

    public string formated_date { get; set; }

}

public class RootObject

{

    public string year { get; set; }

    public string country_iso_alpha_2 { get; set; }

    public List<Holiday> holidays { get; set; }

    public string result { get; set; }

    public object exception { get; set; }

}

Ondersteunde landen en talen

Lage kosten

Wil je de Nationale feestdagen Europa API gaan gebruiken in je applicatie vraag dan een API_KEY aan door onderstaande formulier in te vullen. De kosten zijn kosten € 25,- per jaar tot 1.000 verzoeken per maand of € 125,- per jaar tot 10.000 verzoeken per maand.

Vraag voor grotere volumes een offerte.