Erste Schritte

Von der Installation bis zum ersten erfolgreichen Versand in etwa zehn Minuten.

1. Installieren und Health-Zugriff erteilen

Beim ersten Start bittet Courier um rein lesenden Zugriff auf Workouts und Schlaf. Erteile den Kategorien Zugriff, die die App sehen soll.

iOS verschweigt die Antwort

Apple erlaubt Apps nicht abzufragen, ob Lese-Zugriff erteilt oder verweigert wurde — eine Verweigerung sieht einfach aus wie „keine Daten". Wenn Courier auf Wartet auf Druck stehen bleibt, prüfe Health-App → dein Profil → Datenschutz → Apps → Courier und stelle sicher, dass die Kategorien aktiviert sind. Die Seite Redaktion → Datenquelle in Courier verlinkt direkt dorthin.

2. Die Tagesausgabe durchblättern

Der Tab Heute zeigt die aktuelle Ausgabe: den Schlaf der letzten Nacht (Phasen, Dauer, Score, Vitalwerte) und die Workouts von gestern (Karte, Herzfrequenz, Tempo, Höhenmeter). Wenn dein iPhone gerade erst von einer Apple Watch synchronisiert hat, zieh zum Aktualisieren nach unten.

3. Deinen ersten Abonnenten hinzufügen

Ein Abonnent ist ein Endpunkt, der deine Daten empfängt. Für einen ersten Test brauchst du keinen eigenen Server:

1. Öffne webhook.site auf einem beliebigen Computer und kopiere deine eindeutige URL.
2. In Courier: Redaktion → Abonnenten → Hinzufügen.
3. Gib einen Namen (etwa Test), füge die URL ein, lass die Methode auf POST.
4. Wähle die Datenart, die dieser Abonnent empfängt: Workout, Schlaf, Anmerkung oder Wetter. Nimm Workout oder Schlaf — je nachdem, wofür du Daten hast.
5. Speichern. Die Authentifizierung kann für webhook.site auf Keine bleiben.

Ein Abonnent empfängt genau eine Datenart. Um Workouts und Schlaf zu senden, füge zwei Abonnenten hinzu (sie können dieselbe URL teilen).

4. Etwas versenden

Nutze den Test-Button im Abonnenten-Editor, um sofort ein Beispiel zu senden — die HTTP-Antwort wird direkt in der App angezeigt. Prüfe dann webhook.site: Dort liegt der canonical JSON-Datensatz. Diese JSON-Struktur ist in JavaScript-Transformation dokumentiert — genau das empfängt dein Server, wenn kein Transformations-Skript gesetzt ist.

Für echte Daten öffne Redaktion → Stapelversand, wähle einen Zeitraum und versende manuell — oder warte einfach: Mit aktiviertem Auto-Versand (der Standard) wird das nächste Workout oder die nächste Nacht Schlaf von selbst zugestellt.

5. Laufen lassen

• Hintergrundzustellung: Wenn Apple Health neue Daten empfängt, weckt iOS Courier kurz auf und die App versendet automatisch. Das Timing wird vom System gedrosselt — Minuten bis etwa eine Stunde, im schlimmsten Fall beim nächsten Öffnen der App. Das ist eine iOS-Einschränkung, und Courier ist ehrlich damit.
• Mitteilungen: Unter Redaktion → Mitteilungen wählst du zwischen immer benachrichtigen und nur bei Fehlern.
• Fehlschläge: Alles, was nicht zugestellt werden konnte, landet mit Begründung unter zu prüfen und wartet auf einen manuellen neuen Versuch — nichts wird stillschweigend verworfen, und nichts wird hinter deinem Rücken erneut versucht.

6. Optionale Extras

• Füge das Widget zu deinem Home- oder Sperrbildschirm hinzu — Widgets.
• Diktiere Gedanken zu deinem Tag — Anmerkungen.
• Forme den Payload für deinen Server — JavaScript-Transformation.
• Automatisiere mit Siri — Kurzbefehle.