REST-API Integration für Profis

Dieses Tutorial zeigt Plattformbetreibern, wie sie die terminmich.de Infrastruktur nutzen, um digitale Terminzettel per WhatsApp oder QR-Code automatisiert an Endkunden zu senden.

1. Termin erstellen

Senden Sie einen POST-Request mit den Termindaten. Wichtig ist das ISO-8601 Format für Zeitstempel.

curl -X POST "https://terminmich.de/api/v1/termin" \
     -H "X-API-Key: KUNDEN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "summary": "Haarschnitt Müller",
       "dtstart": "2026-04-10T10:00:00",
       "dtend": "2026-04-10T11:00:00"
     }'

2. Key-Validierung (Ping)

Prüfen Sie beim Speichern des Keys in Ihrem System, ob dieser gültig ist. So vermeiden Sie Übertragungsfehler durch Copy & Paste.

# Antwortet mit 200 OK wenn der Key gültig ist
curl -I -X GET "https://terminmich.de/api/v1/ping" \
     -H "X-API-Key: KUNDEN_API_KEY"

3. Datenmodell (Pydantic / Python)

Falls Sie FastAPI oder Ninja nutzen, können Sie dieses Model direkt als Basis verwenden:

from pydantic import BaseModel
from datetime import datetime

class TerminmichRequest(BaseModel):
    summary: str
    dtstart: datetime  # ISO-8601 Support automatisch
    dtend: datetime