{
    "openapi": "3.1.0",
    "info": {
        "title": "VVE Beheer B.V. publieke gegevens",
        "version": "1.1.0",
        "description": "Alleen-lezen endpoints met dezelfde feiten als de website, zonder sleutel of account. Vrij te gebruiken met bronvermelding (CC BY 4.0).",
        "contact": {
            "email": "vve@vve-beheer.nl",
            "url": "https://www.vve-beheer.nl/voor-ai/"
        },
        "license": {
            "name": "CC BY 4.0",
            "url": "https://creativecommons.org/licenses/by/4.0/"
        }
    },
    "servers": [
        {
            "url": "https://www.vve-beheer.nl"
        }
    ],
    "paths": {
        "/api/": {
            "get": {
                "operationId": "listEndpoints",
                "summary": "Overzicht van alle endpoints",
                "responses": {
                    "200": {
                        "description": "API-overzicht",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/facts.json": {
            "get": {
                "operationId": "getFacts",
                "summary": "Feiten over de organisatie, elk met bron-URL en controledatum",
                "responses": {
                    "200": {
                        "description": "Feitenoverzicht",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/content.json": {
            "get": {
                "operationId": "getContentIndex",
                "summary": "Index van alle publieke pagina's met samenvatting en wijzigingsdatum",
                "responses": {
                    "200": {
                        "description": "Pagina-index",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/answers.json": {
            "get": {
                "operationId": "getAnswers",
                "summary": "Vragen en antwoorden met bronpagina",
                "responses": {
                    "200": {
                        "description": "Vragen en antwoorden",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/changes.json": {
            "get": {
                "operationId": "getChanges",
                "summary": "Wat er het laatst is gepubliceerd of bijgewerkt",
                "responses": {
                    "200": {
                        "description": "Wijzigingen",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/services.json": {
            "get": {
                "operationId": "getServices",
                "summary": "Diensten",
                "responses": {
                    "200": {
                        "description": "Diensten",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/contact.json": {
            "get": {
                "operationId": "getContact",
                "summary": "Contactgegevens en bereikbaarheid",
                "responses": {
                    "200": {
                        "description": "Contact",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/entities.json": {
            "get": {
                "operationId": "getEntities",
                "summary": "Entiteiten en hun onderlinge relaties",
                "responses": {
                    "200": {
                        "description": "Entiteitenkaart",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/health.json": {
            "get": {
                "operationId": "getHealth",
                "summary": "Statuscontrole",
                "responses": {
                    "200": {
                        "description": "Status",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/llms.txt": {
            "get": {
                "operationId": "getLlmsTxt",
                "summary": "Korte gids voor AI-systemen",
                "responses": {
                    "200": {
                        "description": "llms.txt",
                        "content": {
                            "text/plain": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/llms-full.txt": {
            "get": {
                "operationId": "getLlmsFullTxt",
                "summary": "Alle pagina-inhoud als platte tekst",
                "responses": {
                    "200": {
                        "description": "llms-full.txt",
                        "content": {
                            "text/plain": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/ai.txt": {
            "get": {
                "operationId": "getAiTxt",
                "summary": "Wensen rond hergebruik en bronvermelding",
                "responses": {
                    "200": {
                        "description": "ai.txt",
                        "content": {
                            "text/plain": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/license.xml": {
            "get": {
                "operationId": "getLicense",
                "summary": "Licentie in RSL 1.0",
                "responses": {
                    "200": {
                        "description": "RSL",
                        "content": {
                            "application/rsl+xml": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/{pad}.md": {
            "get": {
                "operationId": "getPageMarkdown",
                "summary": "Markdown-versie van een pagina. Hetzelfde staat op /{pad}/index.md, en op het gewone adres met de header Accept: text/markdown.",
                "responses": {
                    "200": {
                        "description": "Markdown",
                        "content": {
                            "text/markdown": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                },
                "parameters": [
                    {
                        "name": "pad",
                        "in": "path",
                        "required": true,
                        "description": "Het pad van de pagina zonder slash aan het eind, bijvoorbeeld \"over\" of \"diensten/technisch-beheer\". De homepagina is \"index\".",
                        "schema": {
                            "type": "string"
                        }
                    }
                ]
            }
        },
        "/{pad}/index.md": {
            "get": {
                "operationId": "getPageMarkdownIndex",
                "summary": "Markdown-versie van een pagina, gelijk aan /{pad}.md.",
                "responses": {
                    "200": {
                        "description": "Markdown",
                        "content": {
                            "text/markdown": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                },
                "parameters": [
                    {
                        "name": "pad",
                        "in": "path",
                        "required": true,
                        "description": "Het pad van de pagina zonder slash aan het eind, bijvoorbeeld \"over\" of \"diensten/technisch-beheer\". De homepagina is \"index\".",
                        "schema": {
                            "type": "string"
                        }
                    }
                ]
            }
        },
        "/.well-known/api-catalog": {
            "get": {
                "operationId": "getApiCatalog",
                "summary": "API-catalogus volgens RFC 9727",
                "responses": {
                    "200": {
                        "description": "Linkset",
                        "content": {
                            "application/linkset+json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/.well-known/agent-skills/index.json": {
            "get": {
                "operationId": "getAgentSkills",
                "summary": "Index van de Agent Skills: uitleg voor agents over welke ingang bij welke vraag hoort",
                "responses": {
                    "200": {
                        "description": "Agent Skills-index",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        },
        "/api/glossary.json": {
            "get": {
                "operationId": "getGlossary",
                "summary": "Begrippenlijst: VvE-termen met een korte definitie",
                "responses": {
                    "200": {
                        "description": "Begrippenlijst",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Niet gewijzigd (ETag of Last-Modified)"
                    }
                }
            }
        }
    }
}