Die erste SMS per API in 5 Minuten senden – der komplette Leitfaden
Die meisten „SMS-Gateways" brauchen Tage zur Einrichtung: Antrag, Vertrag, Vertriebsgespräch, proprietäres SDK. Wir gehen den anderen Weg – Ihre erste SMS über die API geht in 5 Minuten raus: Konto anlegen, Token erzeugen, eine HTTP-Anfrage. In diesem Leitfaden gehen wir den ganzen Weg: vom Konto über funktionierenden Code in vier Sprachen bis zu Webhooks und Fehlerbehandlung – die Dinge, die über den Produktionseinsatz entscheiden.
Schritt 1: Konto und Bearer Token
Erstellen Sie ein Konto auf der Registrierungsseite – Sie erhalten 100 Gratis-SMS, ohne Kreditkarte und ohne Vertrag. Die Aktivierung ist sofort. Im Kundenpanel erzeugen und laden Sie einen Bearer Token herunter (der Token kann auch über den Kundenservice bezogen werden). Behandeln Sie ihn wie ein Passwort – in Umgebungsvariablen (z. B. ACTIO_TOKEN), nie im Repository oder im Frontend. Bei einem Leck widerrufen Sie ihn im Panel und erzeugen einen neuen.
Schritt 2: die erste Anfrage (curl)
Der schnellste Test ist ein einzelner Aufruf aus dem Terminal. Der Endpoint nimmt JSON an und gibt Message ID und Status zurück:
curl -X POST https://api.sendly.link/api/sms \
-H "Authorization: Bearer $ACTIO_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "48732129000",
"body": "Ihr Login-Code: 482910"
}'Zwei Felder machen die Arbeit: to (Empfängernummer, 9–11 Ziffern) und body (Nachrichtentext). Die vollständige Referenz – inklusive des optionalen from-Felds – finden Sie in der Dokumentation.
Schritt 3: Integration in Ihren Stack
Die API ist reines REST und funktioniert mit jeder Sprache, die HTTP spricht – ohne geschlossene Bibliotheken. In Node.js genügt das eingebaute fetch, in Python requests.post(...), in PHP cURL, in Go das Standard-net/http. Fertige Snippets in fünf Sprachen finden Sie in der Dokumentation – kopieren, Token tauschen, fertig.
Schritt 4: Webhooks statt Polling
Eine SMS zu senden ist nur die halbe Geschichte – Sie wollen wissen, ob sie ankam. Sendly schickt Status nicht von allein: im Panel (SMS-Gateway → Diensteinstellungen) aktivieren Sie Zustellung und tragen eine öffentliche URL ein. Beide Schritte sind nötig. Danach kommt statt Polling ein POST application/json (bis zu 36 Versuche von der IP von api.sendly.link; 200 OK beendet die Wiederholungen, ebenso 404 und 418). Zwei Typen: NOTIFICATION (Sendestatus – message_id und status: DELIVERED oder ERROR) und MESSAGE (eingehende SMS – from, to, body). Speichern Sie message_id aus der API-Antwort, um den Callback zuzuordnen. Details: SMS-API-Dokumentation.
Fehlerbehandlung
Behandeln Sie in der Produktion die API-Statuscodes von vornherein. Erfolg ist 200 – die Nachricht wird zum Versand angenommen und die Antwort enthält eine message_id. Fehler: 403 (Autorisierungsproblem), 422 (Validierungsfehler – Details in den Feldern errors.token / errors.to / errors.body) und 429 (Anfragelimit überschritten). Eine gute Integration protokolliert message_id und Status und wendet bei 429 exponentielles Backoff an.
Eine API, drei häufige Anwendungsfälle
Dieselbe API deckt drei sehr unterschiedliche Szenarien ohne Integrationsänderung ab: Transaktionsbenachrichtigungen, 2FA-/OTP-Codes und Massenkampagnen an Tausende Empfänger. Abrechnung pay-as-you-go, ohne Abo und Einstiegsschwelle – den Tarif für Ihr Volumen sehen Sie in den Preisen.
FAQ
Brauche ich einen Vertrag, um die API zu testen?+
Nein. Sie registrieren sich per E-Mail, erhalten 100 Gratis-SMS und testen sofort – ohne Vertrag und ohne Kreditkarte.
In welchen Sprachen gibt es Code-Beispiele?+
curl, Node.js, Python, PHP und Go – alle in der Dokumentation, fertig zum Kopieren.
Woher weiß ich, dass eine SMS zugestellt wurde?+
Im Panel aktivieren Sie die Zustellung und tragen die Webhook-URL ein (beide Schritte). Beim Senden erhalten Sie eine message_id – speichern Sie sie. Danach kommt per Webhook eine NOTIFICATION mit derselben id und DELIVERED oder ERROR. Sie müssen die API nicht abfragen.
Welche Fehlercodes gibt die API zurück?+
Erfolg ist 200 (mit Feld message_id). Fehler: 403 (Autorisierungsproblem), 422 (Validierungsfehler) und 429 (Anfragelimit überschritten).