Die API mit curl ausprobieren
Diese legen einen Bereich an und berichten hinein. Sie haben schon einen? Öffnen Sie ihn und kommen Sie über das Verbinden-Menü zurück, dann ist die UUID für Sie eingesetzt.
Legen Sie einen Bereich an, behalten Sie seine UUID. Wer sie hat, kann hier lesen und schreiben.
Legen Sie eine Aufgabe an, behalten Sie ihre UUID.
Berichten Sie Fortschritt. Jeder Schreibvorgang ersetzt den gesamten Zustand — senden Sie jedes Mal alles.
Beenden Sie sie. Das ist es, was die Benachrichtigung sendet.
Das ist die gesamte Oberfläche, und genau das rufen die CLI und die MCP-Werkzeuge auf. Für etwas, das Sie täglich benutzen, ist die CLI eine Zeile statt vier; um darauf aufzubauen, liegen die API-Referenz und OpenAPI 3.1 unter /openapi.json.
Noch eines, für einen Client, der das oben Genannte nicht kann. Manche Dinge kann man nur eine URL übergeben — ein Uptime-Pinger, ein Webhook-Feld in fremder Software, ein Router oder ein Sensor, eine Cron-Zeile mit einem nackten curl. Sie können weder eine Methode wählen noch einen Body senden, also ist derselbe Schreibvorgang auch als einfaches GET erreichbar.
Das -g ist für curl, nicht für uns: curl liest eckige Klammern in einer URL als Bereich und verweigert die Adresse ohne dieses Flag. Alles, was eine URL einfach abfeuert, braucht nichts Besonderes.
Benutzen Sie es nur, wenn es keine Alternative gibt. Es ist ein GET, das schreibt, also führt alles, was der URL folgt, den Schreibvorgang aus: Fügen Sie sie in einen Chat ein, und die Linkvorschau berichtet für Sie. Wenn Ihr Client überhaupt einen Request-Body senden kann, ist das PUT oben das Richtige.