Sobre la API:
Esta API recupera una lista de todos los días festivos públicos y no públicos que se celebran en un país específico. Consulta para el año actual, los años futuros y los anteriores también. Soporta 195 países en todo el mundo.
Solo pasa el país de tu elección, selecciona el año y hasta el mes y el día que deseas consultar.
Recibirás la fecha del día festivo, su nombre si es público o no, y en qué día de la semana se celebrará.
Lista de países soportados:
AD (Andorra)
AE (دولة الإمارات العربية المتحدة)
AG (Antigua y Barbuda)
AI (Anguila)
AL (Shqipëri)
AM (Հայաստան)
AO (Angola)
AR (Argentina)
AS (Samoa Americana)
AT (Österreich)
AU (Australia)
AW (Aruba)
AX (Landskapet Åland)
AZ (Azərbaycan Respublikası)
BA (Bosnia y Herzegovina)
BB (Barbados)
BD (গণপ্রজাতন্ত্রী বাংলাদেশ)
BE (Bélgica)
BF (Burkina Faso)
BG (България)
BH (مملكة البحرين)
BI (República del Burundi)
BJ (República del Benín)
BL (San Bartolomé)
BM (Bermudas)
BN (Negara Brunei Darussalam)
BO (Bolivia)
BQ (Caribisch Nederland)
BR (Brasil)
BS (Bahamas)
BW (Botsuana)
BY (Рэспубліка Беларусь)
BZ (Belice)
CA (Canadá)
CC (Islas Cocos (Keeling))
CD (República Democrática del Congo)
CF (República Centroafricana)
CG (República del Congo)
CH (Suiza)
CI (República de Côte d'Ivoire)
CK (Islas Cook)
CL (Chile)
CM (Camerún)
CN (中华人民共和国)
CO (Colombia)
CR (Costa Rica)
CU (Cuba)
CV (República de Cabo Verde)
CW (Curaçao)
CX (Isla de Navidad)
CY (Κύπρος)
CZ (Česká republika)
DE (Alemania)
DJ (República de Yibuti)
DK (Dinamarca)
DM (Dominica)
DO (República Dominicana)
DZ (الجمهورية الجزائرية الديمقراطية الشعبية)
EC (Ecuador)
EE (Eesti)
EG (جمهورية مصر العربية)
EH (الجمهورية العربية الصحراوية الديمقراطية)
ER (Eritrea)
ES (España)
ET (ኢትዮጵያ)
FI (Finlandia)
FJ (Matanitu Tugalala o Viti)
FO (Føroyar)
FR (Francia)
GA (Gabon)
GB (Reino Unido)
GD (Granada)
GE (საქართველო)
GF (Guayana Francesa)
GG (Guernsey)
GH (Ghana)
GI (Gibraltar)
GL (Kalaallit Nunaat)
GM (Gambia)
GN (Guinea)
GP (Guadalupe)
GQ (República de Guinea Ecuatorial)
GR (Ελλάδα)
GT (Guatemala)
GU (Guam)
GW (Guinea-Bisau)
GY (Guyana)
HK (香港)
HN (Honduras)
HR (Croacia)
HT (Haití)
HU (Hungría)
IC (Islas Canarias)
ID (Indonesia)
IE (Irlanda)
IL (מְדִינַת יִשְׂרָאֵל)
IM (Isla de Man)
IS (Islandia)
IT (Italia)
JE (Jersey)
JM (Jamaica)
JP (日本)
KE (Kenia)
KM (Unión de Comoras)
KN (San Cristóbal y Nieves)
KR (대한민국)
KY (Islas Caimán)
LC (Santa Lucía)
LI (Liechtenstein)
LR (Liberia)
LS (Muso oa Lesotho)
LT (Lituania)
LU (Luxemburgo)
LV (Letonia)
LY (دولة ليبيا)
MA (المملكة المغربية)
MC (Mónaco)
MD (República de Moldavia)
ME (Montenegro)
MF (San Martín)
MG (República de Madagascar)
MK (Република Македонија)
ML (República de Malí)
MQ (Martínica)
MR (الجمهورية الإسلامية الموريتانية)
MS (Montserrat)
MT (Malta)
MW (Malawi)
MX (México)
MY (Malasia)
MZ (Moçambique)
NA (Namibia)
NC (Nueva Caledonia)
NE (República del Níger)
NG (Nigeria)
NI (Nicaragua)
NL (Países Bajos)
NO (Noruega)
NZ (Nueva Zelanda)
PA (Panamá)
PE (Perú)
PH (Filipinas)
PL (Polonia)
PM (San Pedro y Miquelón)
PR (Puerto Rico)
PT (Portugal)
PY (Paraguay)
RE (Reunión)
RO (Rumania)
RS (Република Србија)
RU (Rusia)
RW (Rwanda)
SC (Seychelles)
SD (جمهورية السودان)
SE (Suecia)
SG (Singapur)
SH (Santa Elena)
SI (República de Eslovenia)
SJ (Svalbard y Jan Mayen)
SK (República Eslovaca)
SL (Sierra Leona)
SM (San Marino)
SN (República de Senegal)
SO (Jamhuuriyadda Federaalka Soomaaliya)
SR (Surinam)
SS (Sudán del Sur)
ST (São Tomé y Príncipe)
SV (El Salvador)
SX (Sint Maarten)
SZ (Eswatini)
TC (Islas Turcas y Caicos)
TD (جمهورية تشاد)
TG (República Togolesa)
TN (الجمهورية التونسية)
TO (Puleʻanga Fakatuʻi ʻo Tonga)
TR (Turquía)
TT (Trinidad y Tobago)
TW (中華民國)
TZ (Tanzania)
UA (Україна)
UG (Uganda)
US (Estados Unidos de América)
UY (Uruguay)
VA (Estado de la Ciudad del Vaticano)
VC (San Vicente y las Granadinas)
VE (Venezuela)
VG (Islas Vírgenes Británicas)
VI (Islas Vírgenes de los Estados Unidos)
VN (Cộng hòa Xã hội chủ nghĩa Việt Nam)
VU (República de Vanuatu)
XK (Republika e Kosovës)
YT (Mayotte)
ZA (Sudáfrica)
ZM (Zambia)
ZW (Zimbabue)
Esta API es ideal para aquellos que desean hacer un seguimiento de cualquier día festivo en el país de su elección. Podrás detectar cuántos días laborables tendrá el año y tomar decisiones basadas en esa información.
Si eres una agencia de viajes y deseas ofrecer ofertas especiales en base a un día festivo específico, puedes lograrlo con esta API.
Reconoce dónde se llevará a cabo el día festivo, para que sepas si es un día laborable o un día de fin de semana.
Aparte del número de llamadas a la API por mes:
Plan Gratis: 1 solicitud por segundo.
Plan Básico: 100 solicitudes por segundo.
Para usar este endpoint, solo ejecútalo y obtendrás todos los países disponibles.
{"message":"Available Countries","total":233,"countriesAvailable":["afghanistan","albania","algeria","american-samoa","andorra","angola","anguilla","antigua-and-barbuda","argentina","armenia","aruba","australia","austria","azerbaijan","bahrain","bangladesh","barbados","belarus","belgium","belize","benin","bermuda","bhutan","bolivia","bosnia","botswana","brazil","british-virgin-islands","brunei","bulgaria","burkina-faso","burundi","cape-verde","cambodia","cameroon","canada","cayman-islands","central-african-republic","chad","chile","china","colombia","comores","republic-of-the-congo","dr-congo","cook-islands","costa-rica","ivory-coast","croatia","cuba","curacao","cyprus","czech","denmark","djibouti","dominica","dominican-republic","timor-leste","ecuador","egypt","el-salvador","guineaecuatorial","eritrea","estonia","eswatini","ethiopia","falkland-islands","faroe-islands","fiji","finland","france","french-guiana","french-polynesia","gabon","gambia","georgia","germany","ghana","gibraltar","greece","greenland","grenada","guadeloupe","guam","guatemala","guernsey","guinea","guinea-bissau","guyana","haiti","honduras","hong-kong","hungary","iceland","india","indonesia","iran","iraq","ireland","isle-of-man","israel","italy","jamaica","japan","jersey","jordan","kazakhstan","kenya","kiribati","kosovo","kuwait","kyrgyzstan","laos","latvia","lebanon","lesotho","liberia","libya","liechtenstein","lithuania","luxembourg","macau","madagascar","malawi","malaysia","maldives","mali","malta","marshall-islands","martinique","mauritania","mauritius","mayotte","mexico","micronesia","moldova","monaco","mongolia","montenegro","montserrat","morocco","mozambique","myanmar","namibia","nauru","nepal","netherlands","new-caledonia","new-zealand","nicaragua","niger","nigeria","norfolk-island","north-korea","macedonia","northern-mariana-islands","norway","oman","pakistan","palau","panama","papua-new-guinea","paraguay","peru","philippines","poland","portugal","puerto-rico","qatar","reunion","romania","russia","rwanda","saint-helena","saint-kitts-and-nevis","saint-lucia","saint-martin","saint-pierre-and-miquelon","saint-vincent-and-the-grenadines","samoa","san-marino","sao-tome-and-principe","saudi-arabia","senegal","serbia","seychelles","sierra-leone","singapore","sint-maarten","slovakia","slovenia","solomon-islands","somalia","south-africa","south-korea","south-sudan","spain","sri-lanka","saint-barthelemy","sudan","suriname","sweden","switzerland","syria","taiwan","tajikistan","tanzania","thailand","bahamas","togo","tonga","trinidad","tunisia","turkey","turkmenistan","turks-and-caicos-islands","tuvalu","uganda","ukraine","united-arab-emirates","uk","us","uruguay","united-states-virgin-islands","uzbekistan","vanuatu","vatican-city-state","venezuela","vietnam","wallis-and-futuna","yemen","zambia","zimbabwe"]}
curl --location --request GET 'https://zylalabs.com/api/260/comprobar+festivos.+api/7772/pa%c3%adses+disponibles.' --header 'Authorization: Bearer YOUR_API_KEY'
Para utilizar este endpoint, debes ingresar un nombre de país y un año (opcional).
Días festivos por país. - Características del Endpoint
Objeto | Descripción |
---|---|
country |
[Requerido] Indicates a country name |
year |
Opcional Indicates a year |
{"country":"denmark","year":2024,"holidays":[{"date":"Jan 1 - Monday","name":"New Year's Day","type":"National Holiday","details":""},{"date":"Jan 14 - Sunday","name":"Accession of King Frederik X","type":"Observance","details":""},{"date":"Feb 11 - Sunday","name":"Carnival","type":"Observance","details":""},{"date":"Feb 14 - Wednesday","name":"Valentine's Day","type":"Observance","details":""},{"date":"Mar 20 - Wednesday","name":"March Equinox","type":"Season","details":""},{"date":"Mar 24 - Sunday","name":"Palm Sunday","type":"Observance","details":""},{"date":"Mar 28 - Thursday","name":"Maundy Thursday","type":"National Holiday","details":""},{"date":"Mar 29 - Friday","name":"Good Friday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Easter Sunday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Daylight Saving Time starts","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Apr 1 - Monday","name":"Easter Monday","type":"National Holiday","details":""},{"date":"Apr 26 - Friday","name":"Great Prayer Day","type":"Observance","details":""},{"date":"May 1 - Wednesday","name":"Labor Day / May Day","type":"Private Sector Holiday","details":""},{"date":"May 5 - Sunday","name":"Liberation Day","type":"Observance","details":""},{"date":"May 9 - Thursday","name":"Ascension Day","type":"National Holiday","details":""},{"date":"May 12 - Sunday","name":"Mother’s Day","type":"Observance","details":""},{"date":"May 19 - Sunday","name":"Whit Sunday","type":"National Holiday","details":""},{"date":"May 20 - Monday","name":"Whit Monday","type":"National Holiday","details":""},{"date":"Jun 5 - Wednesday","name":"Father’s Day","type":"Observance","details":""},{"date":"Jun 5 - Wednesday","name":"Constitution Day","type":"Private Sector Holiday","details":""},{"date":"Jun 20 - Thursday","name":"June Solstice","type":"Season","details":""},{"date":"Sep 22 - Sunday","name":"September Equinox","type":"Season","details":""},{"date":"Oct 27 - Sunday","name":"Daylight Saving Time ends","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Oct 31 - Thursday","name":"Halloween","type":"Observance","details":""},{"date":"Dec 21 - Saturday","name":"December Solstice","type":"Season","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Observance","details":""},{"date":"Dec 25 - Wednesday","name":"Christmas Day","type":"National Holiday","details":""},{"date":"Dec 26 - Thursday","name":"2nd Christmas Day","type":"National Holiday","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Observance","details":""}]}
curl --location --request GET 'https://zylalabs.com/api/260/comprobar+festivos.+api/7773/d%c3%adas+festivos+por+pa%c3%ads.?country=Denmark&year=2024' --header 'Authorization: Bearer YOUR_API_KEY'
Encabezado | Descripción |
---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key . Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
The "Get Holidays" endpoint returns a list of holidays for a specified country and year, including details like date, name, type (public or non-public), and the day of the week. The "Available Countries" endpoint provides a list of all supported countries. The "Holidays by Country" endpoint returns holidays for a specific country and year, detailing the date, name, type, and additional information.
Key fields in the response data include "date" (holiday date), "localName" (name in the local language), "name" (holiday name), "type" (public or non-public), and "countryCode" (ISO code of the country). These fields help identify and categorize each holiday.
The response data is organized in JSON format, with each holiday represented as an object within an array. Each object contains key-value pairs for attributes like date, name, and type, making it easy to parse and utilize programmatically.
The "Get Holidays" and "Holidays by Country" endpoints require parameters such as "countryCode" (ISO code of the country) and "year" (optional). Users can customize requests by specifying the month and day for more precise holiday information.
The "Get Holidays" endpoint provides a comprehensive list of holidays for a specified country and year. The "Available Countries" endpoint lists all countries supported by the API. The "Holidays by Country" endpoint offers detailed holiday information for a specific country, including observances and national holidays.
Users can utilize the returned data to plan events, manage work schedules, or create travel itineraries. For example, by analyzing the number of public holidays in a year, businesses can assess potential operational days and adjust staffing accordingly.
The data is sourced from official government holiday calendars and reputable international databases. This ensures a high level of accuracy and reliability in the holiday information provided by the API.
If a request returns partial or empty results, users should verify the parameters used, such as the country code and year. Additionally, checking the API documentation for supported countries and valid date ranges can help ensure accurate requests.
Zyla API Hub es como una gran tienda de APIs, donde puedes encontrar miles de ellas en un solo lugar. También ofrecemos soporte dedicado y monitoreo en tiempo real de todas las APIs. Una vez que te registres, puedes elegir qué APIs quieres usar. Solo recuerda que cada API necesita su propia suscripción. Pero si te suscribes a varias, usarás la misma clave para todas, lo que hace todo más fácil para ti.
Los precios se muestran en USD (dólar estadounidense), EUR (euro), CAD (dólar canadiense), AUD (dólar australiano) y GBP (libra esterlina). Aceptamos todas las principales tarjetas de débito y crédito. Nuestro sistema de pago utiliza la última tecnología de seguridad y está respaldado por Stripe, una de las compañías de pago más confiables del mundo. Si tienes algún problema para pagar con tarjeta, contáctanos en [email protected]
Además, si ya tienes una suscripción activa en cualquiera de estas monedas (USD, EUR, CAD, AUD, GBP), esa moneda se mantendrá para suscripciones posteriores. Puedes cambiar la moneda en cualquier momento siempre que no tengas suscripciones activas.
La moneda local que aparece en la página de precios se basa en el país de tu dirección IP y se proporciona solo como referencia. Los precios reales están en USD (dólar estadounidense). Cuando realices un pago, el cargo aparecerá en tu estado de cuenta en USD, incluso si ves el monto equivalente en tu moneda local en nuestro sitio web. Esto significa que no puedes pagar directamente en tu moneda local.
Ocasionalmente, un banco puede rechazar el cargo debido a sus configuraciones de protección contra fraude. Te sugerimos comunicarte con tu banco primero para verificar si están bloqueando nuestros cargos. También puedes acceder al Portal de Facturación y cambiar la tarjeta asociada para realizar el pago. Si esto no funciona y necesitas más ayuda, por favor contacta a nuestro equipo en [email protected]
Los precios se determinan mediante una suscripción recurrente mensual o anual, dependiendo del plan elegido.
Las llamadas a la API se descuentan de tu plan en base a solicitudes exitosas. Cada plan incluye una cantidad específica de llamadas que puedes realizar por mes. Solo las llamadas exitosas, indicadas por una respuesta con estado 200, se contarán en tu total. Esto asegura que las solicitudes fallidas o incompletas no afecten tu cuota mensual.
Zyla API Hub funciona con un sistema de suscripción mensual recurrente. Tu ciclo de facturación comenzará el día en que compres uno de los planes de pago, y se renovará el mismo día del mes siguiente. Así que recuerda cancelar tu suscripción antes si quieres evitar futuros cargos.
Para actualizar tu plan de suscripción actual, simplemente ve a la página de precios de la API y selecciona el plan al que deseas actualizarte. La actualización será instantánea, permitiéndote disfrutar inmediatamente de las funciones del nuevo plan. Ten en cuenta que las llamadas restantes de tu plan anterior no se transferirán al nuevo plan, por lo que debes considerar esto al actualizar. Se te cobrará el monto total del nuevo plan.
Para verificar cuántas llamadas a la API te quedan en el mes actual, revisa el campo 'X-Zyla-API-Calls-Monthly-Remaining' en el encabezado de la respuesta. Por ejemplo, si tu plan permite 1,000 solicitudes por mes y has usado 100, este campo mostrará 900 llamadas restantes.
Para ver el número máximo de solicitudes a la API que permite tu plan, revisa el encabezado de la respuesta 'X-Zyla-RateLimit-Limit'. Por ejemplo, si tu plan incluye 1,000 solicitudes por mes, este encabezado mostrará 1,000.
El encabezado 'X-Zyla-RateLimit-Reset' muestra el número de segundos hasta que tu límite se restablezca. Esto te indica cuándo tu conteo de solicitudes se reiniciará. Por ejemplo, si muestra 3,600, significa que faltan 3,600 segundos para que el límite se restablezca.
Sí, puedes cancelar tu plan en cualquier momento desde tu cuenta, seleccionando la opción de cancelación en la página de Facturación. Ten en cuenta que las actualizaciones, degradaciones y cancelaciones tienen efecto inmediato. Además, al cancelar ya no tendrás acceso al servicio, incluso si te quedaban llamadas en tu cuota.
Puedes contactarnos a través de nuestro canal de chat para recibir asistencia inmediata. Siempre estamos en línea de 8 a. m. a 5 p. m. (EST). Si nos contactas fuera de ese horario, te responderemos lo antes posible. Además, puedes escribirnos por correo electrónico a [email protected]
Para darte la oportunidad de probar nuestras APIs sin compromiso, ofrecemos una prueba gratuita de 7 días que te permite realizar hasta 50 llamadas a la API sin costo. Esta prueba solo se puede usar una vez, por lo que recomendamos aplicarla a la API que más te interese. Aunque la mayoría de nuestras APIs ofrecen prueba gratuita, algunas pueden no hacerlo. La prueba finaliza después de 7 días o cuando realices 50 solicitudes, lo que ocurra primero. Si alcanzas el límite de 50 solicitudes durante la prueba, deberás "Iniciar tu Plan de Pago" para continuar haciendo solicitudes. Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios. Alternativamente, si no cancelas tu suscripción antes del día 7, tu prueba gratuita finalizará y tu plan se cobrará automáticamente, otorgándote acceso a todas las llamadas a la API especificadas en tu plan. Ten esto en cuenta para evitar cargos no deseados.
Después de 7 días, se te cobrará el monto total del plan al que estabas suscrito durante la prueba. Por lo tanto, es importante cancelar antes de que finalice el periodo de prueba. No se aceptan solicitudes de reembolso por olvidar cancelar a tiempo.
Cuando te suscribes a una prueba gratuita de una API, puedes realizar hasta 50 llamadas. Si deseas realizar más llamadas después de este límite, la API te pedirá que "Inicies tu Plan de Pago". Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios.
Las Órdenes de Pago se procesan entre el día 20 y el 30 de cada mes. Si envías tu solicitud antes del día 20, tu pago será procesado dentro de ese período.
Nivel de Servicio:
100%
Tiempo de Respuesta:
451ms
Nivel de Servicio:
40%
Tiempo de Respuesta:
418ms
Nivel de Servicio:
75%
Tiempo de Respuesta:
1.745ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.736ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
228ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.886ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
129ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
154ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.245ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
373ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
830ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
623ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.045ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
916ms
Nivel de Servicio:
97%
Tiempo de Respuesta:
1.414ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.953ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.052ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
4.430ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.795ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
482ms