¿Qué endpoints están disponibles en la API de Normatia?

La API de Normatia está en https://api.normatia.com. Con una clave puedes leer parcelas con sus afecciones y su planeamiento, los datos técnicos de un municipio y el texto de la normativa, consultar tus proyectos y hacer preguntas o comprobaciones sobre ellos.

Las rutas de datos (/v1) no gastan consultas.

Parcelas

Una parcela por su referencia catastral, la que contiene un punto o las de una dirección («Calle Mayor 5, Madrid»), y el autocompletado de direcciones mientras se escribe. Con include, en la misma llamada: sus afecciones capa a capa (constraints), su planeamiento (zoning), lo edificado (buildings), sus inmuebles (units) y su geometría (geometry). Una capa sin datos sale como no_data, que nunca quiere decir «no afectada».

GET /v1/parcels/{ref}?include=constraints,zoning
GET /v1/parcels?lat=37.4251&lon=-5.9741
GET /v1/layers
GET /v1/coverage?place=ES-41091

/v1/layers describe las capas de afección y sus fuentes, y /v1/coverage dice qué datos hay cargados en un municipio.

Municipios

Busca un municipio, provincia o comunidad por su nombre o su código INE, y obtén sus datos técnicos (zona climática, sismicidad, nieve, viento, lluvia, radón…), cada uno con la norma de la que sale, y cuántas normas le aplican. El identificador es ES- seguido del código INE (por ejemplo, ES-41091 para Sevilla).

GET /v1/places?q=sevilla
GET /v1/places/{place}

Normativa

El catálogo (también filtrado por municipio: las normas que aplican allí, de la estatal a la municipal), las versiones de cada norma, su índice y el texto de cada sección, artículo por artículo.

GET /v1/regulations?place=ES-41091
GET /v1/regulations/{slug}
GET /v1/regulations/{slug}/contents
GET /v1/regulations/{slug}/sections/{section}

Cada versión dice si su texto está curado a mano (curated: true) o convertido de forma automática y sin revisar (curated: false). En ese caso, contrástalo con su documento original, que va en source_url.

Cuenta y pruebas

Comprueba la clave y su organización, el consumo del mes, tus claves y las parcelas del entorno de pruebas.

GET /v1/me
GET /v1/usage
GET /v1/keys
DELETE /v1/keys/{key_id}
GET /v1/sandbox

Proyectos

Lista los proyectos de la organización de la clave y consulta el contexto de uno: ubicación, normativa seleccionada y documentos.

GET /api/v1/projects
GET /api/v1/project/info

Consultas

Pregunta en lenguaje natural sobre un proyecto, o comprueba si un valor técnico cumple la normativa del municipio de tu proyecto activo. Las dos usan un modelo de lenguaje y gastan una consulta del cupo de tu organización.

POST /api/v2/ask
POST /api/v1/verify

Rutas anteriores

Las rutas de normativa y localización anteriores a /v1 siguen funcionando para las integraciones que ya las usan. Para una integración nueva, mejor las de /v1.

GET /api/v1/codes/search?q=accesibilidad
GET /api/v1/codes/{slug}
GET /api/v1/codes/{slug}/latest
GET /api/v1/codes/{slug}/{version}
GET /api/v1/location/search?q=sevilla
GET /api/v1/location/{geo_id}

Autenticación

Todas las peticiones llevan la clave en la cabecera Authorization:

Authorization: Bearer sk-normatia-...

Las claves se crean en Mi cuenta > Claves API. La API se activa por organización: si la tuya no la tiene, las rutas responden con un error 403 api_not_enabled. Escríbenos a hola@normatia.com para activarla. Para probar sin activarla, crea una clave de prueba: responde con el entorno de pruebas.

Las rutas de datos admiten 60 peticiones por minuto por clave y 300 en toda la organización. Las consultas siguen el límite por minuto del plan de tu organización.

Documentación completa

Los parámetros, las respuestas y los errores de cada ruta están en docs.normatia.com.