De API proberen met curl

Maak een ruimte aan, bewaar de uuid. Wie hem heeft kan hier lezen en schrijven.

Maak een taak aan, bewaar de uuid.

Rapporteer voortgang. Elke schrijfactie vervangt de hele staat — stuur elke keer alles mee.

Rond hem af. Dit is wat de melding stuurt.

Dat is het hele oppervlak, en het is wat de CLI en de MCP-tools aanroepen. Voor iets wat je dagelijks draait is de CLI één regel in plaats van vier; om erop te bouwen staan de API-referentie en OpenAPI 3.1 op /openapi.json.

Nog één, voor een client die het bovenstaande niet kan. Sommige dingen kun je alleen een URL geven — een uptime-pinger, een webhookveld in andermans product, een router of een sensor, een cron-regel met een kale curl. Ze kunnen geen methode kiezen en geen body sturen, dus dezelfde schrijfactie is ook bereikbaar als een gewone GET.

De -g is voor curl, niet voor ons: curl leest vierkante haken in een URL als een reeks en weigert het adres zonder die vlag. Alles wat simpelweg een URL afvuurt heeft niets bijzonders nodig.

Gebruik het alleen als er geen alternatief is. Het is een GET die schrijft, dus alles wat de URL volgt voert de schrijfactie uit: plak hem in een chat en de linkvoorbeeldweergave rapporteert voor je. Kan je client überhaupt een request-body sturen, dan is de PUT hierboven de juiste.