Operaciones con feriados
Si tiene alguna duda respecto al uso de las funciones, no dude en ponerse en contacto con nosotros.
Para realizar cualquier llamada a la API, primero debe solicitar un token y enviarlo junto con cada solicitud. Un mismo token puede ser usado durante 5 minutos. Transcurridos esos minutos, se deberá solicitar un nuevo token.
La petición de token se realiza mediante la siguiente llamada, utilizando la clave de API que recibió de parte nuestra:
https://www.mundapi.cl/api/Auth/{apiKey}
Se recibirá el valor del token como una propiedad de un objeto JSON:
{
"data": token
}
Luego, para cada llamada a la API, se debe incluir el siguiente encabezado:
Authorization: Bearer {token}
Content-Type: application/json
Endpoint
https://www.mundapi.cl/api/Holidays/Country/{country:int}/Date/{year:int}/{month:int?}
Obtiene los feriados de determinado mes y año para el país cuya identificación viene dada por la parámetro country, de tipo entero.
El parámetro year es un número entero que indica el año, y el parámetro month, que también es un entero, inidica el mes, pero es opcional. Si no se indica, se obtienen los feriados del año completo.
https://www.mundapi.cl/api/Holidays/Country/44/Date/2021/9
[
{
"Fecha": "2021-01-01T00:00:00",
"Recurrente": false,
"Descripcion": "Todos los Días Domingos",
"Tipo": "Civil",
"Irrenunciable": false,
"DiaSemana": 0,
"Comentario": "",
"GruposEspeciales": [],
"Ciudades": [],
"Regiones": [],
"Leyes": [
{
"Nombre": "Ley 2.977",
"Link": "http://www.leychile.cl/Navegar?idNorma=23639"
}
]
},
{
"Fecha": "2021-09-17T00:00:00",
"Recurrente": false,
"Descripcion": "Feriado Adicional",
"Tipo": "Civil",
"Irrenunciable": false,
"DiaSemana": 999,
"Comentario": "",
"GruposEspeciales": [],
"Ciudades": [],
"Regiones": [],
"Leyes": []
},
{
"Fecha": "2021-09-18T00:00:00",
"Recurrente": true,
"Descripcion": "Independencia Nacional",
"Tipo": "Civil",
"Irrenunciable": true,
"DiaSemana": 999,
"Comentario": "",
"GruposEspeciales": [],
"Ciudades": [],
"Regiones": [],
"Leyes": [
{
"Nombre": "Ley 2.977",
"Link": "http://www.leychile.cl/Navegar?idNorma=23639"
},
{
"Nombre": "Ley 19.973",
"Link": "http://www.leychile.cl/Navegar?idNorma=230132"
}
]
},
{
"Fecha": "2021-09-19T00:00:00",
"Recurrente": true,
"Descripcion": "Día de las Glorias del Ejército",
"Tipo": "Civil",
"Irrenunciable": true,
"DiaSemana": 999,
"Comentario": "",
"GruposEspeciales": [],
"Ciudades": [],
"Regiones": [],
"Leyes": [
{
"Nombre": "Ley 2.977",
"Link": "http://www.leychile.cl/Navegar?idNorma=23639"
},
{
"Nombre": "Ley 20.629",
"Link": "http://www.leychile.cl/Navegar?idNorma=1043726"
}
]
},
{
"Fecha": "2021-09-20T00:00:00",
"Recurrente": true,
"Descripcion": "Fiestas Patrias",
"Tipo": "Civil",
"Irrenunciable": false,
"DiaSemana": 999,
"Comentario": "",
"GruposEspeciales": [],
"Ciudades": [],
"Regiones": [],
"Leyes": [
{
"Nombre": "Ley 20.215",
"Link": "http://www.leychile.cl/Navegar?idNorma=264651"
}
]
}
]
La propiedad DiaSemana se define del siguiente modo: 0 = Domingo, 1 = Lunes, 2 = Martes, 3 = Miércoles, 4 = Jueves, 5 = Viernes, 6 = Sábado, 999 = Día de la semana que corresponde a la fecha indicada por la propiedad Fecha.
Endpoint
https://www.mundapi.cl/api/Holidays/Country/{country:int}/Dates
Cuerpo de la llamada
{
"start": "AAAA-MM-DD",
"end": "AAAA-MM-DD"
}
Significado de los parámetros
| start | Fecha inicial en formato AAAA-MM-DD. |
|---|---|
| end | Fecha final en formato AAAA-MM-DD. Debe ser igual o mayor que la fecha inicial. |
Obtiene los feriados entre ciertas fechas para el país cuya identificación viene dada por la parámetro country, de tipo entero.
https://www.mundapi.cl/api/Holidays/Country/44/Dates
{
"start": "2021-12-01",
"end": "2021-12-15"
}
[
{
"Fecha": "2021-01-01T00:00:00",
"Recurrente": false,
"Descripcion": "Todos los Días Domingos",
"Tipo": "Civil",
"Irrenunciable": false,
"DiaSemana": 0,
"Comentario": "",
"GruposEspeciales": [],
"Ciudades": [],
"Regiones": [],
"Leyes": [
{
"Nombre": "Ley 2.977",
"Link": "http://www.leychile.cl/Navegar?idNorma=23639"
}
]
},
{
"Fecha": "2021-12-08T00:00:00",
"Recurrente": true,
"Descripcion": "Inmaculada Concepción",
"Tipo": "Religioso",
"Irrenunciable": false,
"DiaSemana": 999,
"Comentario": "",
"GruposEspeciales": [],
"Ciudades": [],
"Regiones": [],
"Leyes": [
{
"Nombre": "Ley 2.977",
"Link": "http://www.leychile.cl/Navegar?idNorma=23639"
}
]
}
]
La propiedad DiaSemana se define del siguiente modo: 0 = Domingo, 1 = Lunes, 2 = Martes, 3 = Miércoles, 4 = Jueves, 5 = Viernes, 6 = Sábado, 999 = Día de la semana que corresponde a la fecha indicada por la propiedad Fecha.
Endpoint
https://www.mundapi.cl/api/Holidays/Country/{country:int}/Difference
Cuerpo de la llamada
{
"start": "AAAA-MM-DD",
"end": "AAAA-MM-DD",
"excludeHolidays": "true" o "false",
"includeFirstDay": "true" o "false",
"onlyBusinessDays": "true" o "false"
}
Significado de los parámetros
| start | Fecha inicial en formato AAAA-MM-DD. |
|---|---|
| end | Fecha final en formato AAAA-MM-DD. Debe ser igual o mayor que la fecha inicial. |
| excludeHolidays | Si es true, la cuenta de días debe dejar fuera a los feriados. En caso contrario, debe incluirlos. El día domingo no se considera feriado ya que entra en la categoría de fin de semana. |
| includeFirstDay | Si es true, la cuenta de días debe incluir el día inicial del rango. En caso contrario, no lo incluirá. |
| onlyBusinessDays | Si es true, la cuenta de días debe considerar sólo de lunes a viernes. En caso contrario, incluirá los días de fines de semana. |
Obtiene la diferencia entre 2 fechas, en días, considerando los feriados para el país cuya identificación viene dada por la parámetro country, de tipo entero.
https://www.mundapi.cl/api/Holidays/Country/44/Difference
{
"start": "2021-12-01",
"end": "2021-12-15",
"excludeHolidays": "true",
"includeFirstDay": "false",
"onlyBusinessDays": "true"
}
9