Nationale feestdagen API Europa

Gratis te gebruiken

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 API is gratis in gebruik tot 1000 verzoeken per maand. Wil je meer verzoeken per maand uitvoeren dan zijn de kosten € 25,- per jaar tot 100.000 verzoeken per maand.

Vraag voor grotere volumes een offerte.

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

Land	Taal	Landcode	Taalcode
België	French	BE	FR
België	Nederlands; Flemish	BE	NL
Bulgarije	Bulgarian	BG	BG
Denemarken	Danish	DK	DA
Duitsland	German	DE	DE
Estland	Estonian	EE	ET
Finland	Finnish	FI	FI
Finland	Northern Sami	FI	SE
Finland	Swedish	FI	SV
Frankrijk	Breton	FR	BR
Frankrijk	Corsican	FR	CO
Frankrijk	French	FR	FR
Frankrijk	Occitan	FR	OC
Griekenland	Greek	GR	EL
Groot-Brittannië	English	GB	EN
Groot-Brittannië	Gaelic	GB	GD
Groot-Brittannië	Welsh	GB	CY
Hongarije	Hungarian	HU	HU
Ierland	English	IE	EN
Ierland	Irish	IE	GA
Italië	Italian	IT	IT
Letland	Latvian	LV	LV
Litouwen	Lithuanian	LT	LT
Luxemburg	French	LU	FR
Luxemburg	German	LU	DE
Luxemburg	Luxembourgish	LU	LB
Malta	Maltese	MT	MT
Nederland	Nederlands; Flemish	NL	NL
Nederland	Western Frisian	NL	FY
Oostenrijk	German	AT	DE
Polen	Polish	PL	PL
Portugal	Portuguese	PT	PT
Roemenië	Moldovan	RO	RO
Slovenië	Slovenian	SI	SL
Slowakije	Slovak	SK	SK
Spanje	Basque	ES	EU
Spanje	Catalan	ES	CA
Spanje	Galician	ES	GL
Spanje	Spanish	ES	ES
Tsjechië	Czech	CZ	CS
Zweden	Northern Sami	SE	SE
Zweden	Swedish	SE	SV