Migración de versión 1 a versión 2

La versión 1 por año seguirá activa cumpliendo con su actual funcionamiento, por lo que se puede migrar en cualquier momento.

Principalmente la versión 2 tiene un sólo recurso donde se pueden obtener los feriados por año, se quitaron los recursos /actual y /próximo, para el próximo feriado hay un ejemplo de como lograr el mismo resultado con la nueva versión en la sección Ejemplos. Estos recursos serán removidos de la versión 1, el 1ero de Junio del 2017

La versión 2 devuelve por defecto los feriados sin los opcionales, el parámetro excluir=opcional para la versión 2 es incluir=opcional y es requerido para obtener los feriados opcionales

Ejemplos de versión 1 a versión 2:

Con Opcionales:

  • Version 1: GET http://nolaborables.com.ar/api/v1/2016
  • Version 2: GET http://nolaborables.com.ar/api/v2/feriados/2016?incluir=opcional

Sin Opcionales:

  • Version 1: GET http://nolaborables.com.ar/api/v1/2016?excluir=opcional
  • Version 2: GET http://nolaborables.com.ar/api/v2/feriados/2016

Respuesta JSON

La respuesta de la nueva versión mantiene el mismo formato que la versión 1 la diferencia es que para los feriados trasladables el feriado se devuelve en la fecha del traslado con una propiedad original con la fecha en formato DD-MM

Comparación:

Versión 1:

{
    "dia": 17,
    "mes": 8,
    "tipo": "trasladable",
    "motivo": "Paso a la Inmortalidad del General José de San Martín",
    "traslado": 15
}

Versión 2:

{
    "dia": 15,
    "mes": 8,
    "tipo": "trasladable",
    "motivo": "Paso a la Inmortalidad del General José de San Martín",
    "original": "17-08",
    "id": "san-martin"
}

Por último la versión 2 expone identificadores para los feriados, en cada feriado habrá una propiedad id con un string único para ese feriado, el propósito es poder identificar los feriados para su manejo específico y poder agregar información en cada uno a futuro (por ej: decreto).

Cambios principales:

  • Se eliminó de la versión 2 los recursos de actual y próximo
  • En la respuesta los feriados trasladables tienen fecha del traslado en vez del feriado original
  • El query excluir=opcional pasó a incluir=opcional , por lo que ahora por defecto se devuelve sin feriados opcionales
  • Se eliminó el soporte de JSONP completamente de la api (ambas versiones)

results matching ""

    No results matching ""