{"openapi":"3.1.0","info":{"title":"Grondslag API","description":"Publieke API van Grondslag. Stel via /ask een vraag over de EU AI-verordening (AI Act) en krijg een gegrond antwoord met citaat en artikelnummer, plus een stempel met de stand van de wetgeving. Informatie, geen juridisch advies. Vrij te gebruiken met bronvermelding (CC BY 4.0). Per IP gerate-limit.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"version":"1.0.0"},"servers":[{"url":"https://grondslag.eu/api","description":"Productie"}],"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/ask":{"post":{"summary":"Stel een vraag over de AI-verordening","description":"Geeft een gegrond antwoord met citaten (artikelnummer + fragment + bron-URL) en de stand van de wetgeving. `geen_bron` is waar als er geen passende grondslag is gevonden. Per IP gerate-limit; bij overschrijding volgt HTTP 429.","operationId":"ask_ask_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskVraag"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskAntwoord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bronnen/status":{"get":{"summary":"Bronnen Status","description":"Stand van de dagelijkse bronnencheck. Niet-200 bij een gedetecteerde\nwijziging is bewust: de AI-OS-watchdog ziet alles behalve 200 als alarm,\ndus de melding loopt via de bestaande route zonder extra integratie.","operationId":"bronnen_status_bronnen_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/inzending":{"post":{"summary":"Inzending","description":"Opt-in na een onbeantwoorde vraag: bewaart alléén de vraagtekst (zelfde\ngrenzen als /ask), zodat corpusgaten vindbaar worden. Geen IP, geen sessie;\nretentie en dagcap zitten in app/inzendingen.py.","operationId":"inzending_inzending_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskVraag"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bezoek":{"post":{"summary":"Bezoek","description":"Telt een paginabezoek. Geen IP, geen cookie, geen user-agent — alleen het\npad, en alleen als het een bestaande pagina is.","operationId":"bezoek_bezoek_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bezoek"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/nieuws":{"get":{"summary":"Nieuws Lijst","description":"Gepubliceerde nieuwsitems, nieuwste eerst. Alleen wat de redacteur\nexpliciet heeft goedgekeurd — concepten zijn hier onzichtbaar.","operationId":"nieuws_lijst_nieuws_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/NieuwsUit"},"type":"array","title":"Response Nieuws Lijst Nieuws Get"}}}}}}},"/nieuws.xml":{"get":{"summary":"Nieuws Feed","description":"RSS 2.0 van de gepubliceerde nieuwsitems, zodat nieuwsbrieven en\naggregators de AI-Act-updates automatisch oppikken. Publiek bereikbaar via\n/api/nieuws.xml (zelfde /api-mapping als /api/nieuws).","operationId":"nieuws_feed_nieuws_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/nieuws/concepten":{"get":{"summary":"Nieuws Concepten","operationId":"nieuws_concepten_nieuws_concepten_get","parameters":[{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NieuwsUit"},"title":"Response Nieuws Concepten Nieuws Concepten Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/nieuws/{item_id}":{"patch":{"summary":"Nieuws Bijwerken","description":"Redactieslag: samenvatting bijwerken en/of publiceren/afwijzen.\nAfgewezen items blijven bestaan (de URL is de dedupe), maar verdwijnen\nuit de conceptenlijst en komen nooit op de site.","operationId":"nieuws_bijwerken_nieuws__item_id__patch","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer","title":"Item Id"}},{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NieuwsWijziging"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NieuwsUit"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AskAntwoord":{"properties":{"antwoord":{"type":"string","title":"Antwoord"},"citaten":{"items":{"$ref":"#/components/schemas/CitaatUit"},"type":"array","title":"Citaten"},"stand_van_wetgeving":{"type":"string","title":"Stand Van Wetgeving"},"geen_bron":{"type":"boolean","title":"Geen Bron"}},"type":"object","required":["antwoord","citaten","stand_van_wetgeving","geen_bron"],"title":"AskAntwoord"},"AskVraag":{"properties":{"vraag":{"type":"string","maxLength":1000,"minLength":3,"title":"Vraag"}},"type":"object","required":["vraag"],"title":"AskVraag"},"Bezoek":{"properties":{"pad":{"type":"string","title":"Pad"}},"type":"object","required":["pad"],"title":"Bezoek"},"CitaatUit":{"properties":{"ref":{"type":"string","title":"Ref"},"fragment":{"type":"string","title":"Fragment"},"bron":{"type":"string","title":"Bron"},"url":{"type":"string","title":"Url"}},"type":"object","required":["ref","fragment","bron","url"],"title":"CitaatUit"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"NieuwsUit":{"properties":{"id":{"type":"integer","title":"Id"},"bron":{"type":"string","title":"Bron"},"url":{"type":"string","title":"Url"},"titel":{"type":"string","title":"Titel"},"datum":{"type":"string","title":"Datum"},"samenvatting":{"type":"string","title":"Samenvatting"}},"type":"object","required":["id","bron","url","titel","datum","samenvatting"],"title":"NieuwsUit"},"NieuwsWijziging":{"properties":{"samenvatting":{"anyOf":[{"type":"string","maxLength":2000,"minLength":3},{"type":"null"}],"title":"Samenvatting"},"status":{"anyOf":[{"type":"string","enum":["gepubliceerd","afgewezen"]},{"type":"null"}],"title":"Status"}},"type":"object","title":"NieuwsWijziging"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}