{"openapi":"3.1.0","info":{"title":"Memoria Civil Open Data API","version":"2.2.0","description":"API de reutilización sobre 100.000 registros sintéticos. En una implantación real, el acceso estará sujeto a la política y normativa aplicables."},"servers":[{"url":"https://0.0.0.0:3000"}],"paths":{"/api/open-data/births":{"get":{"summary":"Consultar births","description":"Datos exclusivamente sintéticos en esta PoC.","parameters":[{"name":"year_from","in":"query","required":false,"description":"Año inicial (1910–1980)","schema":{"type":"integer"}},{"name":"year_to","in":"query","required":false,"description":"Año final (1910–1980)","schema":{"type":"integer"}},{"name":"decade","in":"query","required":false,"description":"Década 1910–1970","schema":{"type":"integer"}},{"name":"district","in":"query","required":false,"description":"Distrito normalizado","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Resultados por página, máximo 200","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"Identificador del último registro recibido","schema":{"type":"integer"}}],"responses":{"200":{"description":"Página de resultados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/open-data/deaths":{"get":{"summary":"Consultar deaths","description":"Datos exclusivamente sintéticos en esta PoC.","parameters":[{"name":"year_from","in":"query","required":false,"description":"Año inicial (1910–1980)","schema":{"type":"integer"}},{"name":"year_to","in":"query","required":false,"description":"Año final (1910–1980)","schema":{"type":"integer"}},{"name":"decade","in":"query","required":false,"description":"Década 1910–1970","schema":{"type":"integer"}},{"name":"district","in":"query","required":false,"description":"Distrito normalizado","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Resultados por página, máximo 200","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"Identificador del último registro recibido","schema":{"type":"integer"}}],"responses":{"200":{"description":"Página de resultados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/open-data/marriages":{"get":{"summary":"Consultar marriages","description":"Datos exclusivamente sintéticos en esta PoC.","parameters":[{"name":"year_from","in":"query","required":false,"description":"Año inicial (1910–1980)","schema":{"type":"integer"}},{"name":"year_to","in":"query","required":false,"description":"Año final (1910–1980)","schema":{"type":"integer"}},{"name":"decade","in":"query","required":false,"description":"Década 1910–1970","schema":{"type":"integer"}},{"name":"district","in":"query","required":false,"description":"Distrito normalizado","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Resultados por página, máximo 200","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"Identificador del último registro recibido","schema":{"type":"integer"}}],"responses":{"200":{"description":"Página de resultados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"$ref":"#/components/responses/Invalid"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"schemas":{"Page":{"type":"object","properties":{"metadata":{"type":"object"},"links":{"type":"object"},"data":{"type":"array","items":{"type":"object"}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Invalid":{"description":"Parámetros no válidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Límite temporal superado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}