Skip to content
Normatia

Entorno de pruebas

Entorno de pruebas

Section titled “Entorno de pruebas”

Una clave de prueba sirve para integrar la API antes de contratarla: responde con datos reales, pero solo de un conjunto fijo de parcelas. No gasta cupo ni consulta el modelo de lenguaje.

La clave

Section titled “La clave”

En normatia.com, Mi cuenta > Claves API > Clave de prueba. La puede crear cualquier miembro de cualquier organización, sin la API activada; como mucho cinco activas a la vez.

Empieza por sk-normatia-test- y se usa como cualquier otra:

Terminal window
curl https://api.normatia.com/v1/me -H "Authorization: Bearer sk-normatia-test-..."

GET /v1/me dice "mode": "test". El código que funciona con la clave de prueba funciona igual con la de vivo: solo cambia la clave.

Qué responde

Section titled “Qué responde”
RutaCon una clave de prueba
/v1/parcels/{ref}Las parcelas de prueba, con la respuesta real grabada de la base y todos los include. Otra referencia da 404 not_in_sandbox
/v1/parcels?lat=&lon=Solo encuentra las parcelas de prueba que contienen el punto
/v1/layers, /v1/coverageIgual que con la de vivo
/v1/placesIgual que con la de vivo
/v1/regulationsEl catálogo entero. El índice (/contents) y el texto, solo de las versiones curadas a mano (curated: true): los de las demás dan 404 not_in_sandbox
/v1/me, /v1/usage, /v1/keysIgual que con la de vivo
/v1/sandboxLa lista de las parcelas de prueba
Consultas, comprobaciones, proyectos y las rutas de /api403 not_available_in_sandbox

El límite es de 30 peticiones por minuto. La clave de prueba no sirve en el servidor MCP (403 test_key_not_supported).

Las parcelas

Section titled “Las parcelas”

Unas sesenta, casi todas de Madrid y Barcelona, elegidas para cubrir los casos que hay que saber tratar: sin ninguna afección, afectada por varias capas, por el patrimonio, por servidumbres aeronáuticas, por carreteras y ferrocarriles, en varias zonas de planeamiento, dentro de un ámbito, rústica, un edificio con muchos inmuebles, y un municipio sin planeamiento cargado (zoning vacío, en Ajofrín). La zona inundable y la servidumbre de costas, en Valencia y Málaga. Además, la de los ejemplos de esta documentación, 6963301TG3466N, en Sevilla.

La lista, con el caso que cubre cada una, la da la propia API:

Terminal window
curl https://api.normatia.com/v1/sandbox -H "Authorization: Bearer $NORMATIA_API_KEY"
{
  "object": "sandbox",
  "recorded_at": "2026-11-01",
  "parcels": [
    {
      "ref": "6963301TG3466N",
      "place": { "geo_id": "ES-41091", "ine": "41091", "name": "SEVILLA" },
      "case": "Sevilla. La parcela de los ejemplos de la documentación",
      "centroid": { "lat": 37.425128, "lon": -5.974094 }
    }
  ],
  "docs_url": "https://docs.normatia.com/api-reference/pruebas/"
}

Errores

Section titled “Errores”
EstadocodeCuándo
404not_in_sandboxLa parcela, o el índice o el texto de esa versión de la norma, no está en el entorno de pruebas. Trae sandbox_url
403not_available_in_sandboxLa ruta no responde con una clave de prueba
403test_key_not_supportedLa clave de prueba no sirve en el servidor MCP