{
    "openapi": "3.1.0",
    "info": {
        "title": "ReHabita · API pública d'indicadors",
        "version": "1.0.0",
        "description": "Pensada per a la recerca, la consultoria i altres administracions. Les consultes de lectura no necessiten cap credencial."
    },
    "servers": [
        {
            "url": "https://rehabita.premm.es/api/v1"
        }
    ],
    "paths": {
        "/indicadors": {
            "get": {
                "summary": "Catàleg d'indicadors",
                "parameters": [
                    {
                        "name": "periode",
                        "in": "query",
                        "required": false,
                        "description": "Període de referència, per exemple 2026-Q1",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/indicadors/{code}": {
            "get": {
                "summary": "Catàleg d'indicadors",
                "parameters": [
                    {
                        "name": "code",
                        "in": "path",
                        "required": true,
                        "description": "Codi de l'indicador",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "404": {
                        "description": "Not found"
                    }
                }
            }
        },
        "/districtes": {
            "get": {
                "summary": "Potencial de rehabilitació per districte",
                "parameters": [
                    {
                        "name": "districte",
                        "in": "query",
                        "required": false,
                        "description": "Nom del districte",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "periode",
                        "in": "query",
                        "required": false,
                        "description": "Versió de les dades",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/districtes.geojson": {
            "get": {
                "summary": "Potencial de rehabilitació per districte (GeoJSON)",
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    }
}