Sonstiges

SMS4You Public API: REST-API zum Empfang von SMS, OTPs und virtuellen Rufnummern

1.7.2026
SMS4You Public API: REST-API zum Empfang von SMS, OTPs und virtuellen Rufnummern

Wir stellen vor: Die öffentliche API von „SMS4You“ – Automatisieren Sie den SMS-Empfang und die Nummernverwaltung

Wir freuen uns, die Einführung einer Funktion bekannt zu geben, auf die viele von Ihnen schon lange gewartet haben – die öffentliche API von SMS4You. Jetzt können Sie alles, was Sie bisher manuell in Ihrem Konto erledigt haben, programmgesteuert ausführen: Nummern kaufen, Codes aus SMS und E-Mails abrufen sowie Ihr Guthaben und Ihre Tarife verfolgen. Ihre Skripte, Bots und Registrierungssysteme können direkt mit SMS4You zusammenarbeiten – ganz ohne einen einzigen Klick.

Im Folgenden erklären wir euch genau, was wir veröffentlicht haben, warum ihr es braucht und wie ihr in fünf Minuten loslegen könnt.

Die wichtigsten Funktionen auf einen Blick

  • Eine voll funktionsfähige REST-API für OTP-Aktivierungen (SMS-Empfang) und E-Mail-Aktivierungen.
  • Ein Katalog mit Ländern, Diensten und aktuellen Preisen – alles, was in Ihrem Konto sichtbar ist, ist auch über die API verfügbar.
  • Webhooks: Codes und Statusaktualisierungen werden automatisch an Ihren Server gesendet, ohne dass ein ständiges Abfragen erforderlich ist.
  • Kompatibilität mit dem SMS-Activate-Protokoll: Portieren Sie bestehende Integrationen, indem Sie lediglich eine Adresse ändern.
  • Einfache Authentifizierung über ein Token, das Sie selbst in Ihrem Konto erstellen.
  • Interaktive Dokumentation mit der Möglichkeit, Anfragen direkt in Ihrem Browser zu testen.

Warum Sie eine API benötigen

Das manuelle Kaufen von Nummern funktioniert gut, wenn es nur wenige Aktivierungen gibt. Sobald Sie jedoch mit Dutzenden oder Hunderten von Registrierungen, der Massenverarbeitung oder der Integration des SMS-Empfangs in Ihr eigenes Produkt zu tun haben, wird das Klicken durch die Benutzeroberfläche mühsam. Die API löst genau dieses Problem: Sie definieren die Logik einmal im Code, und alles andere geschieht automatisch – in jeder Größenordnung und zu jeder Tageszeit.

Typische Anwendungsfälle, für die wir dies entwickelt haben:

  • automatische Kontoregistrierung und -verifizierung in Ihrer Software;
  • Massenverarbeitung und Tests, die eine große Anzahl von Telefonnummern nacheinander erfordern;
  • die Integration des SMS-Code-Empfangs direkt in Ihren Dienst oder Ihr Produkt;
  • Migration bestehender Integrationen, die ursprünglich für andere Anbieter entwickelt wurden.

Was die API leisten kann

1. Aktivierung aus einer Hand: vom Kauf einer Nummer bis zum Erhalt eines Codes

Der gesamte Aktivierungszyklus ist über intuitive REST-Endpunkte zugänglich:

  • Wählen Sie einen Dienst und ein Land aus, prüfen Sie Verfügbarkeit und Preis;
  • eine Nummer mit einer einzigen Anfrage kaufen;
  • die empfangene SMS abrufen (oder E-Mail, falls es sich um eine E-Mail-Aktivierung handelt);
  • den Vorgang abschließen, abbrechen oder eine erneute SMS anfordern – Sie haben die volle Kontrolle über den Status.

Beide Schlüsselprodukte werden unterstützt: SMS-Empfang (OTP) und E-Mail-Aktivierung. Jede Aktivierung verfügt über eine eindeutige Kennung, mit der Sie später darauf verweisen können.

2. Aktueller Katalog und Preise

Die API stellt Echtzeitdaten bereit:

  • eine Liste der Länder mit Vorwahlen;
  • eine Liste der Dienste (für SMS und E-Mail);
  • Preise für einen bestimmten Dienst oder ein bestimmtes Land sowie eine vollständige Preisliste mit seitenweisen Ergebnissen.

Wichtiger Hinweis: Die Preise werden unter Berücksichtigung Ihres persönlichen Rabatts angezeigt. Der in der API-Antwort angezeigte Betrag entspricht genau dem Betrag, der von Ihrem Guthaben abgezogen wird.

3. Webhooks: Codes werden automatisch an Sie gesendet

Das ständige Abfragen des Servers beim Warten auf SMS-Nachrichten ist aufwendig und langsam. Deshalb bietet SMS4You Webhooks an: Sobald eine neue Nachricht eintrifft oder sich der Aktivierungsstatus ändert, senden wir automatisch eine HTTP-Anfrage an die von Ihnen angegebenen Adressen.

  • Sie erhalten Ereignisse sofort, ohne Abfragen;
  • Jede Anfrage ist mit einer HMAC-Signatur signiert, sodass Sie überprüfen können, ob die Anfrage tatsächlich von uns stammt;
  • Wir implementieren Wiederholungsmechanismen für den Fall, dass Ihr Server vorübergehend nicht erreichbar ist;
  • Für diejenigen, die den eingehenden Datenverkehr über eine Whitelist beschränken, veröffentlichen wir eine Liste der IP-Adressen, von denen aus Webhooks gesendet werden.

Zusammen mit der REST-API vervollständigt dies die Integration: Sie senden die Anfragen selbst und erhalten Aktualisierungen über einen Push-Kanal.

4. Kompatibilität mit SMS-Activate: Migration ohne Neuprogrammierung

Darauf sind wir besonders stolz. Wenn Sie bereits Software haben, die auf der SMS-Activate-API basiert, müssen Sie Ihre Integration nicht neu programmieren. SMS4You unterstützt ein kompatibles Protokoll: Ändern Sie einfach die Serveradresse auf unsere und ersetzen Sie den Schlüssel durch Ihren eigenen.

Ihr bestehender Code, Ihre Bibliotheken und Bots funktionieren weiterhin wie bisher, nun jedoch mit den Telefonnummern, Preisen und der Qualität von „SMS4You“. Dadurch ist der Wechsel zu uns nur eine einzige Zeile in Ihrer Konfigurationsdatei – statt wochenlanger Entwicklungsarbeit.

5. Sichere und einfache Authentifizierung

Keine Benutzernamen oder Passwörter in Ihren Skripten. Melden Sie sich bei Ihrem Konto an, erstellen Sie auf der Registerkarte „API-Token“ ein persönliches Token und verwenden Sie es in Ihren Anfragen. Sie können das Token auf drei Arten übergeben – wählen Sie die für Ihre Bibliothek bequemste aus:

  • im Header Authorization: Bearer <токен>;
  • Header X-Api-Token: <токен>;
  • als Abfrageparameter ?api_token=<токен>.

Sie können mehrere Token erstellen (zum Beispiel ein separates für jedes Projekt) und ein kompromittiertes Token jederzeit widerrufen, ohne dass dies Auswirkungen auf die anderen hat. Der Token-Wert wird nur einmal bei der Erstellung angezeigt – danach wird er ausschließlich von Ihnen gespeichert.

6. Praktische Dokumentation

Wir haben eine interaktive Dokumentation auf Basis von OpenAPI erstellt: Jeder Endpunkt wird beschrieben, der Typ jedes Feldes ist angegeben, und Sie können Anfragen direkt von der Seite aus ausführen, ohne ein Terminal öffnen zu müssen. Es gibt außerdem einen separaten Abschnitt zu Webhooks und dem mit SMS-Activate kompatiblen Protokoll.

Die Dokumentation ist unter docs.sms4you.org verfügbar.

In fünf Minuten loslegen

Basis-API-URL: https://api.sms4you.org/api/v1

Schritt 1. Überprüfen Sie Ihr Kontoguthaben und Ihren Rabatt

curl https://api.sms4you.org/api/v1/me \
  -H "Authorization: Bearer YOU TOKEN"



{
  "data": {
    "name": "Ivan",
    "email": "[email protected]",
    "email_verified": true,
    "balance": "12.3456",
    "currency": "USD",
    "discount_percent": 5
  }
}

Schritt 2. Prüfen Sie den Preis des gewünschten Dienstes

curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
  -H "Authorization: Bearer YOU TOKEN"

Schritt 3: Kaufen Sie eine Nummer

curl -X POST https://api.sms4you.org/api/v1/activations \
  -H "Authorization: Bearer YOU TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 123, "country_id": 7, "price": "0.20"}'

Die Antwort enthält die Telefonnummer und einen Aktivierungscode.

Schritt 4. Rufen Sie die erhaltene SMS ab

curl https://api.sms4you.org/api/v1/activations/АКТИВАЦИЯ_ID/messages \
  -H "Authorization: Bearer YOU TOKEN"

Und wenn Sie einen Webhook eingerichtet haben, müssen Sie diesen Schritt gar nicht ausführen – der Code wird Ihnen automatisch zugesendet.

Beschränkungen und Zuverlässigkeit

  • Die Häufigkeit der Anfragen ist begrenzt (standardmäßig bis zu 120 Anfragen pro Minute), um sicherzustellen, dass der Dienst für alle stabil bleibt.
  • Alle Antworten liegen in einem einheitlichen Format vor, einschließlich Fehlermeldungen: ein eindeutiger Code, eine für Menschen lesbare Meldung und, falls erforderlich, Details. Die Verarbeitung im Code ist ein Kinderspiel.
  • Für Käufe ist eine verifizierte E-Mail-Adresse erforderlich – eine übliche Sicherheitsmaßnahme.

Für wen ist dies gedacht

  • Entwickler, die innerhalb ihres Produkts SMS-Nachrichten empfangen müssen.
  • Arbitrage- und Marketing-Teams, bei denen Registrierungen in einem stetigen Strom eingehen.
  • QA-Teams, die Szenarien mit Telefonverifizierung testen.
  • Alle, die bereits SMS-Activate-kompatible Software nutzen und einen Anbieter suchen, bei dem keine aufwendige Migration erforderlich ist.

Was kommt als Nächstes

Die öffentliche API ist die Grundlage, auf der wir weiter aufbauen werden. Wir planen, unsere Produktabdeckung und Funktionen zu erweitern, indem wir auf Ihre Wünsche eingehen. Wenn Sie einen bestimmten Endpunkt oder ein bestimmtes Szenario vermissen, wenden Sie sich über den Support-Chat an uns: Wir lesen alles und priorisieren, was wirklich benötigt wird.

Probieren Sie es gleich aus:

  1. Melden Sie sich bei Ihrem Konto an und erstellen Sie ein Token auf der Registerkarte „API-Token“.
  2. Öffnen Sie die Dokumentation unter docs.sms4you.org.
  3. Senden Sie Ihre erste Anfrage – und automatisieren Sie den Rest.

Viel Spaß mit der Integration – und mögen Ihre Codes pünktlich ankommen.