API
JSON REST voor een schrijver-agent. Elke aanvraag gaat naar api.php gevolgd door het pad, bijvoorbeeld = htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days. Lokaal is het pad hetzelfde op de ontwikkelserver.
Authenticatie: Authorization: Bearer vb_…. De sleutel maakt een beheerder één keer aan onder Sleutels. Stuur Accept: application/json en, bij een body, Content-Type: application/json. Fouten zijn {"error":"…"} met status 401, 403, 404, 405, 409 of 422.
Dagen
| Methode | Pad | Wat |
|---|---|---|
| GET | /days | Alle dagen, oudste eerst. |
| GET | /days/latest | De nieuwste datum die nog een dagrecord heeft, ook als die onvolledig is. 404 als er nog niets is. |
| GET | /days/gaps | Ontbrekende datums tussen de eerste en de laatste dag, plus dagen met minder dan drie verhalen. |
| GET | /days/JJJJ-MM-DD | Dag met verhalen, vorige en volgende bestaande dag. |
| POST | /days | Maak één volledige dag met precies drie verhalen. |
| PUT | /days/JJJJ-MM-DD | Werk de titel bij en/of vervang alle verhalen (dan weer precies drie). |
| DELETE | /days/JJJJ-MM-DD | Verwijder de dag. |
| POST | /days/JJJJ-MM-DD/stories | Voeg een verhaal toe zolang er minder dan drie zijn. position is optioneel (1, 2 of 3). |
| PUT | /days/JJJJ-MM-DD/stories/1 | Werk titel en/of alinea's van plek 1, 2 of 3 bij. |
| DELETE | /days/JJJJ-MM-DD/stories/2 | Verwijder één verhaal. De andere plekken blijven staan, de dag wordt onvolledig. |
Een verhaal heeft een titel en minstens één alinea. De volgorde in stories wordt plek 1, 2 en 3. Een dag die al bestaat geeft 409. Een ongeldige of onvolledige dag geeft 422.
Voorbeeld: een dag in één aanroep
curl -sS -X POST \
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{"date":"2026-10-05","title":"De herfstwind","stories":[
{"title":"Ochtend","paragraphs":["De wind stond al vroeg aan de deur."]},
{"title":"Middag","paragraphs":["Op het plein joeg een krant zichzelf achterna.","Iemand lachte en liep door."]},
{"title":"Avond","paragraphs":["Het licht in de keuken bleef aan tot de wind ging liggen."]}
]}' \
'= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days'
Laatste datum en gaten
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
'= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/latest'
curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
'= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/gaps'
latest antwoordt met date, title, storyCount en complete. gaps antwoordt met first, latest, missing (datums zonder dag) en incomplete (datums die bestaan maar geen drie verhalen meer hebben, met missingPositions).
Staat een datum in missing, maak hem dan met POST. Staat hij in incomplete, vul de ontbrekende plek met POST /stories of vervang de dag met PUT en precies drie verhalen.
Eén verhaal wijzigen
curl -sS -X PUT \
-H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{"title":"Middaglicht","paragraphs":["De schaduw werd korter."] }' \
'= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days/2026-10-05/stories/2'
Lezers gebruiken deze sleutel niet. Hun gelezen-status hoort bij een ingelogde sessie: POST of DELETE /days/JJJJ-MM-DD/read.