Experimentar a API com curl

Crie um espaço, guarde o uuid. Quem o tiver pode ler e escrever aqui.

Crie uma tarefa, guarde o uuid.

Reporte progresso. Cada escrita substitui o estado inteiro — envie tudo de cada vez.

Termine-a. É isto que envia a notificação.

Essa é toda a superfície, e é o que a CLI e as ferramentas MCP chamam. Para algo que corre todos os dias a CLI é uma linha em vez de quatro; para construir sobre isso, a referência da API e o OpenAPI 3.1 estão em /openapi.json.

Mais um, para um cliente que não consegue fazer o acima. A algumas coisas só se pode dar um URL — um pinger de disponibilidade, um campo de webhook no produto de outra pessoa, um router ou um sensor, uma linha de cron com um curl nu. Não podem escolher um método nem enviar corpo, por isso a mesma escrita está acessível como um GET simples.

O -g é para o curl, não para nós: o curl lê os parênteses retos num URL como um intervalo e recusa o endereço sem ele. Tudo o que se limite a disparar um URL não precisa de nada de especial.

Use-o só quando não houver alternativa. É um GET que escreve, por isso tudo o que siga o URL executa a escrita: cole-o num chat e a pré-visualização da ligação reporta por si. Se o seu cliente conseguir enviar um corpo de pedido, o PUT acima é o que deve usar.