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
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
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
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
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
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 |