Skip to content
Normatia

Primera llamada

Primera llamada

Section titled “Primera llamada”

Cinco llamadas, de la clave a la normativa de una parcela. Todas funcionan con una clave de prueba, sin pagar ni esperar a que te activemos nada. Los ejemplos usan curl; los SDK de TypeScript y Python tienen un método para cada una.

  1. Crea una clave de prueba. En normatia.com, Mi cuenta > Claves API > Clave de prueba. Se ve una sola vez: guárdala en una variable de entorno.

    Terminal window
    export NORMATIA_API_KEY="sk-normatia-test-..."

    Una clave de prueba responde con el entorno de pruebas: unas sesenta parcelas fijas, grabadas de la base real, y el catálogo entero. Para trabajar con todas las parcelas, la clave de siempre (sk-normatia-...), que pide la API activada en tu organización: escríbenos a hola@normatia.com.

  2. Comprueba que funciona. GET /v1/me dice de qué organización es la clave, si es de prueba y sus límites.

    Terminal window
    curl https://api.normatia.com/v1/me \
      -H "Authorization: Bearer $NORMATIA_API_KEY"
    {
      "key": { "mode": "test", "name": "Mi primera llamada", "hint": "3dfa", "scopes": ["data"] },
      "organization": { "name": "Ejemplo Datos S.L.", "api_enabled": false, "mcp_enabled": false },
      "rate_limits": { "data_per_minute": 30, "intelligence_per_minute": 0, "mcp_per_minute": 0 }
    }

  3. Pide una parcela. Por su referencia catastral, con sus afecciones y su planeamiento.

    Terminal window
    curl "https://api.normatia.com/v1/parcels/6963301TG3466N?include=constraints,zoning" \
      -H "Authorization: Bearer $NORMATIA_API_KEY"

    Cada capa de afección sale affected, partially_affected, not_affected, context o no_data, y la zona de planeamiento con sus parámetros. Lo explica Parcelas.

  4. Mira su municipio. El identificador es ES- y el código INE: la parcela trae el suyo en place.geo_id.

    Terminal window
    curl https://api.normatia.com/v1/places/ES-41091 \
      -H "Authorization: Bearer $NORMATIA_API_KEY"

    Los datos técnicos (zona climática, sismicidad, nieve, viento, radón), cada uno con la norma de donde sale. Más en Municipios.

  5. Lee la normativa que le aplica. Las normas del municipio, de la estatal a la municipal, y el texto de cada una sección a sección.

    Terminal window
    curl "https://api.normatia.com/v1/regulations?place=ES-41091&scope=municipal" \
      -H "Authorization: Bearer $NORMATIA_API_KEY"
    

    curl https://api.normatia.com/v1/regulations/cte-db-he/contents \
      -H "Authorization: Bearer $NORMATIA_API_KEY"

    curated dice si el texto está revisado a mano o convertido de forma automática. Con una clave de prueba, el índice y el texto solo de las curadas. Más en Normativa.

Con una clave de vivo, además, las consultas en lenguaje natural sobre un proyecto, con sus fuentes, y las comprobaciones de un valor contra la normativa. Gastan un crédito cada una.

Lo que conviene saber desde el principio

Section titled “Lo que conviene saber desde el principio”
  • Cada respuesta lleva X-Request-Id. Guárdalo en tus registros: si nos escribes por un problema, con él encontramos la llamada.
  • Respeta los límites. Las cabeceras RateLimit-Remaining y RateLimit-Reset dicen cuánto te queda en el minuto; un 429 trae Retry-After con los segundos de espera.
  • Decide por el código del error, no por el texto. En /v1 va en code; en /api/v1 y /api/v2, en detail.error. La lista está en Errores.
  • Lo que no está cargado sale como «sin dato», nunca como «no afectada». Qué hay cargado en cada municipio lo dice /v1/coverage.
  • El consumo se consulta en GET /v1/usage, por ruta y por día.