Referencia completa de la API
La API de Georef cuenta con una documentación interactiva basada en el estándar OpenAPI, que permite explorar todos los endpoints disponibles, sus parámetros, formatos de respuesta y ejemplos de uso en tiempo real.
Esta referencia técnica es una herramienta útil tanto para desarrolladores como para usuarios intermedios que deseen:
- Consultar detalles específicos de cada recurso.
- Probar consultas directamente desde el navegador.
- Ver ejemplos de entradas y salidas reales.
- Conocer la estructura y validación de los parámetros aceptados.
- Descargar la definición en formato yaml o json para integrarla en sus entornos de desarrollo.
Acceso al Swagger (OpenAPI)
La documentación interactiva está disponible en:
https://www.argentina.gob.ar/georef/referencia-completa-de-la-api-georef-v-2
Cómo aprovechar la referencia
Desde el entorno web del Swagger es posible:
- Navegar por cada recurso (por ejemplo,
/provincias,/localidades,/direcciones). - Desplegar las operaciones disponibles (GET).
- Completar los parámetros y ejecutar consultas directamente.
- Visualizar las respuestas formateadas en JSON.
- Exportar la especificación para integrarla con herramientas como Postman, Insomnia o generar SDKs automáticamente.
Para usuarios intermedios, el Swagger también funciona como un generador de URLs listas para ejecutar.
Al completar los campos y enviar la consulta desde la interfaz, se muestra la URL exacta utilizada (por ejemplo: https://apis.datos.gob.ar/georef/api/v2.0/localidades?nombre=rosario&provincia=santa+fe), la cual puede copiarse y reutilizarse directamente desde un navegador, una planilla de cálculo o un entorno de desarrollo externo.
La especificación OpenAPI es abierta, reutilizable y forma parte del compromiso de interoperabilidad del servicio Georef. Puede utilizarse para generar documentación técnica, probar servicios, construir integraciones automatizadas o explorar el funcionamiento interno de la API sin escribir código.