SMS senden per API: POST /sms/send von Android

Der Endpoint, der eine SMS in die Warteschlange eines Ihrer Telefone stellt.

Zuletzt aktualisiert 18. Oktober 2026

POST/api/v1/sms/send

Die Nachricht kommt in die Warteschlange des Geräts und wird in der Reihenfolge des Eingangs verschickt. Die Antwort wartet nicht auf den Versand: queued bedeutet angenommen.

Request-Body

Feld	Typ	Pflicht	Beschreibung
to	string	ja	Nummer im Format E.164 (+14155550100). Eine nationale Nummer gilt für das Land des sendenden Telefons
message	string	ja	Nachrichtentext, bis zu 10.000 Zeichen (etwa 66 SMS in GSM-7). Lange Nachrichten werden als verkettete SMS gesendet
deviceId	string	nein	Das zu verwendende Telefon. Ohne Angabe wählen wir das mit der kürzesten Warteschlange
reference	string	nein	Ihre eigene Kennung, die in den Webhooks dieser Nachricht zurückkommt

Anfrage

curl -X POST https://api.droidsender.com/api/v1/sms/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: DS-live-your-key" \
  -d '{
    "to": "+14155550100",
    "message": "Ihr Termin am 10.08. um 11:15 Uhr ist bestätigt.",
    "deviceId": "dev_oppo_cph2577",
    "reference": "appointment_8841"
  }'

Antwort

{
  "id": "msg_01H8X2",
  "status": "queued",
  "to": "+14155550100",
  "deviceId": "dev_oppo_cph2577",
  "reference": "appointment_8841",
  "segments": 1,
  "encoding": "GSM-7",
  "quota": { "used": 128, "included": 2000, "remaining": 1872 },
  "deviceOnline": true,
  "createdAt": "2026-08-16T14:22:05Z"
}

Wiederholen ohne doppelten Versand

Senden Sie einen Header Idempotency-Key. Wiederholen Sie eine Anfrage mit demselben Schlüssel, erhalten Sie die ursprüngliche Antwort statt einer zweiten SMS. Schlüssel gelten 72 Stunden; ein anderer Body mit demselben Schlüssel liefert 409 idempotency_conflict.

curl -X POST https://api.droidsender.com/api/v1/sms/send \
  -H "X-API-Key: DS-live-your-key" \
  -H "Idempotency-Key: appointment_8841_reminder" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+14155550100", "message": "Erinnerung" }'

Unterhaltung lesen

GET/api/v1/conversations/:id/messages

Liefert den Verlauf in chronologischer Reihenfolge. Die conversationId kommt mit dem Webhook received. limit akzeptiert 1 bis 100, Standard 20.

{
  "conversationId": "conv_9f21",
  "phone": "+14155550100",
  "deviceId": "dev_oppo_cph2577",
  "messages": [
    {
      "id": "msg_01H8X",
      "direction": "outbound",
      "body": "Ihr Termin am 10.08. um 11:15 Uhr ist bestätigt.",
      "status": "delivered",
      "reference": "appointment_8841",
      "at": "2026-08-14T09:02:11Z"
    },
    {
      "id": "msg_01H8Z",
      "direction": "inbound",
      "body": "Donnerstagvormittag, wenn möglich.",
      "status": "delivered",
      "reference": null,
      "at": "2026-08-14T10:30:44Z"
    }
  ]
}

Nachricht später prüfen

GET/api/v1/messages/:id

Liefert den aktuellen Status einer von Ihnen gesendeten Nachricht. Nutzen Sie ihn zum Abgleich, wenn ein Webhook nicht angekommen ist. Empfangene Nachrichten liefert GET /messages/inbound.

{
  "id": "msg_01H8X2",
  "status": "delivered",
  "to": "+14155550100",
  "deviceId": "dev_oppo_cph2577",
  "segments": 1,
  "encoding": "GSM-7",
  "reference": "appointment_8841",
  "createdAt": "2026-08-16T14:22:05Z",
  "deliveredAt": "2026-08-16T14:22:41Z",
  "error": null
}