Rückmeldung

Status abfragen

GET https://smsforge.de/api/sms/123      (Authorization: Bearer TOKEN)

→ {"id":123,"direction":"out","number":"+491711234567","text":"Hallo","status":"delivered",
   "error":null,"sent_at":"2026-10-19T09:15:02+02:00","received_at":null}

Status	Bedeutung
`queued`	Wartet in der Warteschlange.
`sending`	Wird gerade über das Mobilfunk-Modem gesendet.
`sent`	Vom Modem an das Mobilfunknetz übergeben.
`delivered`	Zustellbericht des Empfängernetzes: zugestellt.
`failed`	Fehlgeschlagen; der Grund steht in `error`.

Du siehst nur deine eigenen SMS; fremde oder unbekannte IDs liefern 404. Gesendete SMS werden nach 30 Tagen gelöscht. Statt ständig abzufragen, kannst du Webhooks nutzen.

Gateway-Zustand für dein Monitoring

GET https://smsforge.de/api/health      (ohne Token)

→ {"status":"ok","gateway":"ready","queue":0,"oldest_queued_seconds":null,"checked_at":"2026-10-31T10:00:00+01:00"}

HTTP 200, wenn das Gateway versandbereit ist (oder gewartet wird), sonst 503 (degraded: Modem ohne Netz, down: Modem offline). Passend für Uptime Kuma, UptimeRobot und ähnliche Dienste. Den Verlauf der letzten 30 Tage zeigt die Status-Seite.