Was du brauchst
- Die App Kurzbefehle auf dem iPhone (ist vorinstalliert).
- Deinen persönlichen Token: Einstellungen → „Siri & Kurzbefehle" → Token erzeugen → kopieren. Er wird nur einmal angezeigt.
Schnellster Weg: fertige Kurzbefehle importieren
Die Kurzbefehle liegen als Dateien bereit. Apple verlangt, dass Kurzbefehl-Dateien signiert sind — das geht einmalig auf dem Mac mit einem Befehl.
- Auf dem Mac den Ordner code/kurzbefehle öffnen und signieren.command doppelklicken. Er erzeugt für jede Datei eine signierte Fassung im Unterordner signiert/. (Braucht macOS 12 oder neuer mit der App „Kurzbefehle".)
- Die signierten Dateien per AirDrop aufs iPhone schicken (oder in iCloud Drive legen und dort antippen).
- Auf dem iPhone antippen → die App Kurzbefehle zeigt eine Vorschau → „Kurzbefehl hinzufügen". Beim Hinzufügen fragt er nach deinem Token — einfügen, fertig.
| Datei | Siri-Befehl | Was er tut |
|---|---|---|
| Stundenzettel | „Hey Siri, Stundenzettel" | Hört einen Satz per Diktat und trägt ein: „gestern 8 bis 12:30 Unterricht Elternabend vorbereitet" |
| Stundenzettel tippen | — | Dasselbe mit Texteingabe statt Diktat (z. B. am Mac) |
| Stempeluhr | „Hey Siri, Stempeluhr" | Umschalter: startet den Favoriten oder beendet die laufende Erfassung (Apple Watch) |
| Stempeluhr Start | „Stempeluhr Start" | Nur starten — für die Automation „Ankommen an Schule" |
| Stempeluhr Ende | „Stempeluhr Ende" | Nur beenden |
| Stempeluhr Status | „Stempeluhr Status" | Läuft etwas? Tagessumme, Stundenkonto |
Was du Siri sagen kannst
Beim Nachtragen reicht ein Satz. Die App erkennt Tag, Zeiten, Tätigkeit und den Rest wird zur Notiz:
- „gestern 8 bis 12:30 Unterricht" · „Montag von 7 Uhr 45 bis 13 Uhr 10 Vorbereitung"
- „vorgestern halb neun bis viertel vor zwölf Elterngespräch Familie Müller"
- „am 8.9. 16 bis 17:30 Überstunden Vorbereitung" · „heute 9 bis 10" (ohne Tätigkeit = Favorit)
Tage: heute, gestern, vorgestern, Wochentag (der letzte), 11.9. oder 11.09.2026. Zeiten: 8, 8:30, 8 Uhr 30, halb/viertel. Tätigkeit: Name oder Teil davon; unbekannt → Favorit, Siri sagt es dazu. Siri liest immer vor, was eingetragen wurde — bei Fehlern den Grund.
Von Hand statt Import: „Stundenzettel" in 4 Aktionen
- Text — dein Token einfügen.
- Text diktieren — Sprache Deutsch, Aufnahme beenden Nach Pause. (Nicht „Nach Eingabe fragen" — dort deutet Siri die Antwort als Kalenderfrage.)
- Inhalte von URL abrufen — URL https://zeit.kubisch.consulting/api/kurz/nachtragen, Methode POST, Header Authorization = Bearer + Leerzeichen + Text (Schritt 1), Anfragetext JSON mit einem Feld text = Diktierter Text (Schritt 2).
- Wert für Schlüssel abrufen satz → Ergebnis anzeigen.
Benennen: Stundenzettel. Für „Stempeluhr" (Watch) dasselbe ohne Frage, URL …/api/kurz/toggle, JSON ohne Felder.
„Stempeluhr" auf der Apple Watch
Der Kurzbefehl „Stempeluhr" schaltet um: läuft nichts, startet er deine Favoriten-Tätigkeit; läuft etwas, beendet er es und sagt die Dauer. In den Details des Kurzbefehls „Auf Apple Watch anzeigen" einschalten. Auf der Watch: Kurzbefehle-App öffnen oder als Komplikation aufs Zifferblatt legen — ein Tipp startet, der nächste beendet. Siri auf der Watch: „Stempeluhr".
Getrennte Befehle: /api/kurz/start und /api/kurz/ende funktionieren genauso (POST). /api/kurz/status (GET) sagt dir, ob etwas läuft, die Tagessumme und den Kontostand.
Automation: Beim Ankommen an der Schule starten
- Kurzbefehl „Stempeluhr Start" importieren (siehe oben) — oder von Hand wie „Stempeluhr", nur mit URL …/api/kurz/start.
- Kurzbefehle → Tab Automation → + → Ankommen → Ort: deine Schule, Radius so groß wie möglich (mind. ~100 m) → Zeitbereich 6–18 Uhr → „Sofort ausführen" → Kurzbefehl „Stempeluhr Start".
- Für das Verlassen: Automation Verlassen → Kurzbefehl „Stempeluhr" (umschalten) — oder sicherer: nur eine Mitteilung „Timer läuft noch?" und dann von Hand beenden, damit Hofpause und Bäcker keine Fragmente erzeugen.
An Ferientagen, Feiertagen, Wochenenden und markierten Tagen startet die App nichts und sagt den Grund („Herbstferien — nicht gestartet"). Läuft schon etwas, passiert auch nichts. Die Ortserkennung reagiert mit 1–5 Minuten Verzögerung — die Startzeit kannst du in der App mit −15/−30 min korrigieren.
Wenn etwas nicht klappt
| Siri sagt … | Das hilft |
|---|---|
| „Kein Zugriffsschlüssel" | Header prüfen: Authorization mit Wert Bearer + Leerzeichen + Token. Alternativ Header X-Api-Token = Token (ohne Bearer). |
| „Der Zugriffsschlüssel ist ungültig" | Token wurde widerrufen oder neu erzeugt — aktuellen Token aus den Einstellungen eintragen. |
| „Das Datum habe ich nicht verstanden" | Die Variable im JSON auf Typ Text stellen; oder das Datum mit Datum formatieren (Eigenes Format yyyy-MM-dd, Zeiten HH:mm) vor dem Senden umwandeln. |
| „… überschneidet sich" | Für den Zeitraum gibt es schon einen Eintrag — in der App unter Heute/Auswertung nachsehen. |
| Kurzbefehl bricht mit Netzwerkfehler ab | Internet prüfen; die App braucht die Verbindung (Offline-Warteschlange kommt mit der PWA-Stufe). |
Technische Kurzreferenz
| Endpunkt | Methode | Felder (JSON) |
|---|---|---|
| /api/kurz/nachtragen | POST | text (Freitext) — oder einzeln: datum, von, bis, taetigkeit?, notiz?, art? (arbeit|ueberstunden) |
| /api/kurz/start | POST | taetigkeit? (leer = Favorit) |
| /api/kurz/ende | POST | — |
| /api/kurz/toggle | POST | taetigkeit? |
| /api/kurz/status | GET | — |
| /api/kurz/taetigkeiten | GET | — (liefert namen für „Aus Liste wählen") |
Jede Antwort enthält ok und satz. Fachliche Fehler kommen mit ok=false und HTTP 200, damit Siri den Satz vorliest statt abzubrechen. Nur ein ungültiger Token liefert HTTP 401.