sms.1ne.de - SMS Bridge API

Diese API verbindet deine Android-SMS-App mit deinem Backend.

• Basis-URL: https://sms.1ne.de/api
• Healthcheck: GET https://sms.1ne.de/api/health

Endpunkte

Android-App (Device-Token)

Erforderlicher Header:

• Authorization: Bearer <deviceToken>

Verfügbare Endpunkte:

• POST /api/sms/incoming
• GET /api/sms/outgoing/pending?deviceId=<deviceId>&batteryLevel=<0-100>
• POST /api/sms/outgoing/{id}/status

Backend / Automationen (Server-Token)

Erforderlicher Header:

• X-Server-Token: <SMS_SERVER_TOKEN>

Verfügbarer Endpunkt:

• POST /api/sms/outgoing

Request-Body:

{
  "deviceId": "android-abc",
  "to": "+49123456789",
  "message": "Hallo vom Server",
  "subscriptionId": 1
}

Schnellstart (Server)

1. Abhängigkeiten installieren:
   • composer install
2. .env konfigurieren:
   • cp .env.example .env
   • php artisan key:generate
   • SMS_SERVER_TOKEN=dein_langer_server_token
3. SQLite-Datei anlegen:
   • touch database/database.sqlite
4. Migrationen ausführen:
   • php artisan migrate
5. Device registrieren:
   • php artisan sms:device-create android-abc --name="Mein Handy"
   • Der Befehl zeigt den deviceToken einmalig an.

Beispiel-Requests

Ausgehende SMS anlegen:

curl -X POST "https://sms.1ne.de/api/sms/outgoing" \
  -H "Content-Type: application/json" \
  -H "X-Server-Token: dein_langer_server_token" \
  -d '{"deviceId":"android-abc","to":"+49123456789","message":"Test"}'

Healthcheck:

curl "https://sms.1ne.de/api/health"