Provare l'API con curl

Crea uno spazio, tieni il suo uuid. Chi ce l'ha può leggere e scrivere qui.

Crea un'attività, tieni il suo uuid.

Riporta l'avanzamento. Ogni scrittura sostituisce l'intero stato: manda tutto ogni volta.

Concludila. È questo che manda la notifica.

Questa è tutta la superficie, ed è ciò che chiamano la CLI e gli strumenti MCP. Per qualcosa che usi ogni giorno la CLI è una riga invece di quattro; per costruirci sopra, il riferimento dell'API e OpenAPI 3.1 sono su /openapi.json.

Un'altra ancora, per un client che non può fare quanto sopra. Ad alcune cose si può solo passare un URL: un pinger di uptime, un campo webhook nel prodotto di qualcun altro, un router o un sensore, una riga di cron con un curl nudo. Non possono scegliere un metodo né mandare un corpo, quindi la stessa scrittura è raggiungibile come semplice GET.

Il -g è per curl, non per noi: curl legge le parentesi quadre in un URL come un intervallo e rifiuta l'indirizzo senza di esso. Tutto ciò che si limita a lanciare un URL non ha bisogno di niente di speciale.

Usalo solo quando non c'è alternativa. È un GET che scrive, quindi qualsiasi cosa segua l'URL esegue la scrittura: incollalo in una chat e l'anteprima del link riporta al posto tuo. Se il tuo client può mandare un corpo della richiesta, il PUT qui sopra è quello giusto.