{"openapi":"3.0.3","info":{"title":"dataestado API","description":"API pública de solo lectura sobre instituciones y autoridades del Estado de Chile.","version":"1.0.0"},"servers":[{"url":"https://api.dataestado.cl","description":"Producción"},{"url":"http://localhost:3001","description":"Desarrollo local"}],"tags":[{"name":"Salud","description":"Endpoints de monitoreo del servicio y de la conexión a la base de datos."},{"name":"Ministerios","description":"Consulta de ministerios vigentes y su historial de autoridades."}],"paths":{"/health":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"timestamp":{"type":"string"}},"required":["ok","service","timestamp"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"timestamp":{"type":"string"}},"required":["ok","service","timestamp"]}},"text/plain":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"timestamp":{"type":"string"}},"required":["ok","service","timestamp"]}}}}},"operationId":"getHealth","summary":"Estado general del servicio","description":"Devuelve estado de la API, nombre del servicio y timestamp en formato ISO 8601.","tags":["Salud"]}},"/health/db":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"number"}},"required":["ok"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"ok":{"type":"number"}},"required":["ok"]}},"text/plain":{"schema":{"type":"object","properties":{"ok":{"type":"number"}},"required":["ok"]}}}}},"operationId":"getHealthDb","summary":"Estado de conexión a base de datos","description":"Verifica conectividad con PostgreSQL ejecutando una consulta simple.","tags":["Salud"]}},"/v1/ministries":{"get":{"responses":{"200":{"items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitioWeb","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitioWeb":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}}}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitioWeb","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitioWeb":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}}}}}}},"multipart/form-data":{"schema":{"type":"array","items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitioWeb","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitioWeb":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}}}}}}},"text/plain":{"schema":{"type":"array","items":{"type":"object","required":["id","orden","codigo","nombre","sigla","sitioWeb","autoridades"],"properties":{"id":{"description":"Identificador numérico del ministerio.","type":"number"},"orden":{"description":"Orden oficial del ministerio en el gabinete.","type":"number"},"codigo":{"description":"Código interno del ministerio.","type":"string"},"nombre":{"description":"Nombre vigente del ministerio.","type":"string"},"sigla":{"nullable":true,"anyOf":[{"description":"Sigla vigente del ministerio, si aplica.","type":"string"},{"type":"null"}]},"sitioWeb":{"nullable":true,"anyOf":[{"description":"Sitio web oficial del ministerio, si existe.","type":"string"},{"type":"null"}]},"autoridades":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}}}}}}}}}},"operationId":"getV1Ministries","summary":"Listado de ministerios vigentes","description":"Entrega ministerios vigentes con autoridades actualmente en ejercicio (ministros y subsecretarios).","tags":["Ministerios"]}},"/v1/ministries/{id}/history":{"get":{"parameters":[{"description":"ID numérico del ministerio.","schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}}}},"multipart/form-data":{"schema":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}}}},"text/plain":{"schema":{"type":"array","items":{"type":"object","required":["nombres","apellidos","cargo","genero","fechaInicio","fechaTermino"],"properties":{"nombres":{"description":"Nombres de la autoridad.","type":"string"},"apellidos":{"description":"Apellidos de la autoridad.","type":"string"},"cargo":{"description":"Cargo ocupado por la autoridad.","type":"string"},"genero":{"nullable":true,"anyOf":[{"description":"Género registrado en la fuente oficial.","type":"string"},{"type":"null"}]},"fechaInicio":{"description":"Fecha de inicio de la designación en formato ISO 8601.","format":"date-time","type":"string"},"fechaTermino":{"nullable":true,"anyOf":[{"description":"Fecha de término de la designación en formato ISO 8601. Null cuando está vigente.","format":"date-time","type":"string"},{"type":"null"}]}}}}}}}},"operationId":"getV1MinistriesByIdHistory","summary":"Historial de autoridades por ministerio","description":"Retorna el historial cronológico de designaciones para un ministerio, incluyendo ministros y subsecretarías.","tags":["Ministerios"]}}},"components":{"schemas":{}}}