API-Argentina

La API REST ofrece el listado de provincias, departamentos y localidades que componen la República Argentina. Esta realizada con datos oficiales sacados de datos.gob.ar/ que se normalizaron solo para obtener los nombres y asignar un id. El objetivo principal simplemente era poder consumir estos datos para utilizarlos en formularios o algún listado. Hay que estar registrado para utilizar la API.

Documentación

Enpoint para el registro, recomiendo utilizar POSTMAN para este proceso

POST https://api-argentina.andresromano.net.ar/registro

En la respuesta obtenemos nuestro usuario y password para utilizar la API, luego desde POSTMAN, en Authorization, hay que seleccionar Basic Auth y colocar las credenciales obtenidas. Luego se pueden realizar las peticiones GET.

También podemos aprovechar el generador de código de POSTMAN, para obtener el código para consultar la API pudiendo seleccionar entre distintos lenguajes de programación. Y así poder integralo a nuestro proyecto.

Enpoints

Obtener todas las provincias del país.

GET https://api-argentina.andresromano.net.ar/provincias

Respuesta obtenida

{ "respuesta_para": { "cliente": "api, test", "email": "email@conelquemeregistre.com" }, "cantidad_provincias": 24, "provincias": [ { "id_provincia": "1", "provincia": "Buenos Aires" }, { "id_provincia": "2", "provincia": "Catamarca" }, { "id_provincia": "3", "provincia": "Chaco" }, { "id_provincia": "4", "provincia": "Chubut" }, { "id_provincia": "5", "provincia": "Ciudad Autónoma De Buenos Aires" }, { "id_provincia": "6", "provincia": "Córdoba" }, { "id_provincia": "7", "provincia": "Corrientes" }, { "id_provincia": "8", "provincia": "Entre Ríos" }, { "id_provincia": "9", "provincia": "Formosa" }, { "id_provincia": "10", "provincia": "Jujuy" }, { "id_provincia": "11", "provincia": "La Pampa" }, { "id_provincia": "12", "provincia": "La Rioja" }, { "id_provincia": "13", "provincia": "Mendoza" }, { "id_provincia": "14", "provincia": "Misiones" }, { "id_provincia": "15", "provincia": "Neuquén" }, { "id_provincia": "16", "provincia": "Río Negro" }, { "id_provincia": "17", "provincia": "Salta" }, { "id_provincia": "18", "provincia": "San Juan" }, { "id_provincia": "19", "provincia": "San Luis" }, { "id_provincia": "20", "provincia": "Santa Cruz" }, { "id_provincia": "21", "provincia": "Santa Fe" }, { "id_provincia": "22", "provincia": "Santiago Del Estero" }, { "id_provincia": "23", "provincia": "Tierra Del Fuego, Antártida E Islas Del Atlántico Sur" }, { "id_provincia": "24", "provincia": "Tucumán" } ] }

Obtener una provincia del país, en este caso pasamos una varible GET llamada id_provincia.

GET https://api-argentina.andresromano.net.ar/provincias/?id_provincia=8

Respuesta obtenida

{ "respuesta_para": { "cliente": "api, test", "email": "email@conelquemeregistre.com" }, "provincia": { "id_provincia": "8", "provincia": "Entre Ríos" } }

Para obtener los departamentos que componen una provincia del país, en este caso pasamos una varible GET llamada id_provincia

GET https://api-argentina.andresromano.net.ar/departamentos/?id_provincia=8

Respuesta obtenida

{ "respuesta_para": { "cliente": "api, test", "email": "email@conelquemeregistre.com" }, "cantindad_dptos": 17, "departamentos": [ { "id_departamento": "117", "departamento": "Colón", "provincia": "Entre Ríos" }, { "id_departamento": "136", "departamento": "Concordia", "provincia": "Entre Ríos" }, { "id_departamento": "155", "departamento": "Diamante", "provincia": "Entre Ríos" }, { "id_departamento": "171", "departamento": "Federación", "provincia": "Entre Ríos" }, { "id_departamento": "172", "departamento": "Federal", "provincia": "Entre Ríos" }, { "id_departamento": "173", "departamento": "Feliciano", "provincia": "Entre Ríos" }, { "id_departamento": "227", "departamento": "Gualeguay", "provincia": "Entre Ríos" }, { "id_departamento": "228", "departamento": "Gualeguaychú", "provincia": "Entre Ríos" }, { "id_departamento": "248", "departamento": "Islas Del Ibicuy", "provincia": "Entre Ríos" }, { "id_departamento": "270", "departamento": "La Paz", "provincia": "Entre Ríos" }, { "id_departamento": "343", "departamento": "Nogoyá", "provincia": "Entre Ríos" }, { "id_departamento": "353", "departamento": "Paraná", "provincia": "Entre Ríos" }, { "id_departamento": "459", "departamento": "San Salvador", "provincia": "Entre Ríos" }, { "id_departamento": "483", "departamento": "Tala", "provincia": "Entre Ríos" }, { "id_departamento": "510", "departamento": "Uruguay", "provincia": "Entre Ríos" }, { "id_departamento": "519", "departamento": "Victoria", "provincia": "Entre Ríos" }, { "id_departamento": "522", "departamento": "Villaguay", "provincia": "Entre Ríos" } ] }

Para obtener solo un departamento, en este caso pasamos una varible GET llamada id_departamento

GET https://api-argentina.andresromano.net.ar/departamentos/?id_departamento=211

Respuesta obtenida

{ "respuesta_para": { "cliente": "api, test", "email": "email@conelquemeregistre.com" }, "departamento": { "id_departamento": "211", "departamento": "General Pedernera", "provincia": "San Luis" } }

Para obtener todas las localidades de un departamento, en este caso pasamos una varible GET llamada id_departamento

GET https://api-argentina.andresromano.net.ar/localidades/?id_departamento=211

Respuesta obtenida

{ "respuesta_para": { "cliente": "api, test", "email": "email@conelquemeregistre.com" }, "cantidad_localidades": 14, "localidades": [ { "id_localidad": "25", "localidad": "5ta Brigada", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "1092", "localidad": "Country Club Los Caldenes", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "1847", "localidad": "Juan Jorba", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "1850", "localidad": "Juan Llerena", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "1863", "localidad": "Justo Daract", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "2021", "localidad": "La Punilla", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "2037", "localidad": "La Ribera", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "2210", "localidad": "Lavaisse", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "2598", "localidad": "Nacion Ranquel", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "3294", "localidad": "San Jose Del Morro", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "3967", "localidad": "Villa Mercedes", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "3968", "localidad": "Villa Mercedes", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "4012", "localidad": "Villa Reynolds", "departamento": "General Pedernera", "provincia": "San Luis" }, { "id_localidad": "4027", "localidad": "Villa Salles", "departamento": "General Pedernera", "provincia": "San Luis" } ] }

Usos

El uso más común, y por el que se me ocurrió hacer la API, es poder utilizar los datos en formularios donde se requiere algún tipo de ubicación, pudiendo utilizar no solo la provincias con departamentos y localidades, sino que también podría utilizar solo las localidades dependiendo de lo que necesite. El siguiente formulario está realizado consultando la API, y con AJAX y JQuery, se van rellenando los "select" según las provincia o departamento que se va seleccionando.

Fromulario de prueba

Otro uso podria ser simplemente generar un listado.

Provincias que componen la Rep. Argentina
Buenos Aires
Catamarca
Chaco
Chubut
Ciudad Autónoma De Buenos Aires
Córdoba
Corrientes
Entre Ríos
Formosa
Jujuy
La Pampa
La Rioja
Mendoza
Misiones
Neuquén
Río Negro
Salta
San Juan
San Luis
Santa Cruz
Santa Fe
Santiago Del Estero
Tierra Del Fuego, Antártida E Islas Del Atlántico Sur
Tucumán