Dirección Base URL

Para recuperar las normativas disponibles, deberá utilizar las siguientes URI:

Base URL
http://www.mercosurambiental.net/ws

Patrones URI

/normativa
/normativa/{normativa}
/normativa.json
/normativa.xml

Salida

La salida puede ser especificada concatenando .json o .xml al final del URI del recurso y antes de los diferentes tipos de parámetros para consultar. Si no se especifica, por defecto la salida es json.

Parámetros Adicionales

Los diferentes tipos de datos admitidos en las consultas se describen en la siguiente tabla:

Parametro Tipo Descripción
Entero El tipo esperado es un entero y admite valores >0. Al especificarse un único valor devolverá los registros que coincidan con el valor ingresado. En caso de ingresar 2 valores separados por el carácter | devolverá los datos comprendidos entre ambos.

EJ:
?id=1
?id=1|100
Cadena Cadena de texto alfanumérica con acentos y eñes, cuya longitud máxima por palabra es de 20 caracteres. Considera n términos separados por | y la misma es excluyente.

EJ:
?titulo=mercosur
?titulo=proyecto|Ambiental|gestión
Fecha Se trata de una máscara de fecha representada por una cadena "AAAA-MM-DD" o “AAAA” donde AAAA es un año de 4 dígitos, MM es el mes en 2 dígitos y DD es el día en 2 dígitos. Si se ingresa una única fecha la consulta devolverá los registros cuyo campo coincidan con dicha fecha. En caso de ingresar 2 fechas separadas por | se devolverán los campos cuya fecha se encuentre comprendida entre ambos.

EJ:
?fecha=2013-04-01
?fecha=2013-04-01 | 2013-08-30
?fecha=2009|2012

A continuación se muestra una lista de los parámetros de consulta que están disponibles para este patrón URI. Construir el servicio web a partir de la URL base y los patrones de URI anteriores, luego agregar estos parámetros después del signo de interrogación como separador de consulta (con cada par campo-valor separado por un signo ampersand).
Todos los parámetros son opcionales.

Parametro Valores Permitidos Descripción
id entero Deberá ser un valido id de Normativa.
origen cadena Origen de la normativa.
Valores permitidos:
Argentina, Bolivia, Brasil, Paraguay,Uruguay, Venezuela, Bloque Mercosur.
titulo cadena Título de la normativa.
numero cadena Número de normativa.
tipo cadena Tipo de la normativa
Valores permitidos:
Ley, Decreto, Decreto Ley, Resolución, Convenio Internacional, Recomendación, Directiva, Decisión.
texto cadena Contenido de la normativa. En caso de encontrarse vacio el texto de la normativa se encuentra en el archivo del campo “link”.
link cadena Path relativo al archivo conteniendo el texto de la normativa. En caso de encontrase vacio el contenido de la normativa se encuentra en el campo texto.
dependencia cadena Dependencia de la normativa.
tema cadena Temas vinculados a la normativa
Ej.: Clima, Biodiversidad, Suelo, Educación Ambiental, Sustancias y Productos Químicos, Evaluación de Impacto Ambiental, etc.
fecha fecha Fecha de creación de la norma.

También es posible adicionar parámetros independientemente del recurso que se está consultando, como los que se muestran a continuación:
Todos los parámetros son opcionales.

Parametro Valores Permitidos Descripción
ws_ordc cadena Nombre del campo a partir del cual se realizará el ordenamiento.
Ej: ws_ordc=fecha_inicio
ws_ordt cadena Tipo de ordenamiento de los datos recuperados.
Valores permitidos:
a (ascendente)
d (descendente)
ws_regi entero Registro inicial a partir del cuál recuperar los datos.
ws_regn entero Número total de regitros a recuperar.
ws_cons cadena Tipo de consulta.
Valores permitidos:
l (Lista: Devuelve un subconjunto de los campos)
d (Detalle: Devuelve la totalidad de los campos del recurso)

URI Ejemplos

Haga Click en los links siguientes para visualizar los resultados de ejemplo
desde cada consulta REST. Seleccione ambos, xml o json para ver cada formato
respectivamente. Copie la URL listada para usar como una referencia.

Encontrar normativas sancionadas en los últimos 3 años
http://www.mercosurambiental.net/ws/normativa.json?fecha=2011|2013

Visualiza únicamente las normativas del “Bloque Mercosur” con la palabra “ambiente” en su título
http://www.mercosurambiental.net/ws/normativa.xml?origen=bloque|mercosur&titulo=ambiente

Uso de la API - PHP

Para emplear la API desde PHP utilizamos la libreria cURL que permite conectarse y comunicarse con diferentes tipos de servidores y diferentes tipos de protocolos. cURL hace la petición por medio de HTTP, lo único que debemos hacer es ocuparnos de su resultado que es el valor $decoded->status. En caso de que sea distinto de 200, algo anduvo mal.

Ejemplo JSON

Ejemplo XML

Solución de Problemas

Si usted está teniendo problemas de recuperación de datos, compruebe lo siguiente: