API-Dokumentation
Eine mit sms-activate kompatible handler_api: dieselben Aktionen, Status, Länder- und Dienstcodes, dazu ein Code-Webhook.
handler_api URL
https://allinsms.com/stubs/handler_api.php
REST API Basis
https://allinsms.com/v1
Nummern (handler_api)
GET oder POST mit api_key und action. Länder verwenden die standardmäßigen numerischen IDs (getCountries), Dienste die Standardcodes (tg, wa, go …). Antworten sind reiner Text, sofern nicht anders angegeben.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | Parameter | Antwort | Beschreibung |
|---|---|---|---|
| getBalance | Keine | ACCESS_BALANCE:12.3400 | Aktuelles Guthaben in USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | Eine Nummer kaufen. Sofort berechnet, erstattet, wenn kein Code ankommt. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | Wie getNumber, JSON-Antwort mit Preis und Endzeit. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | Alle 3 bis 5 Sekunden abfragen, bis ein Code ankommt. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | JSON-Status mit dem vollständigen SMS-Text. |
| getFullSms | id | FULL_SMS:Your code is 48213 | Vollständiger Text der letzten SMS. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 bereit, 3 weiterer Code, 6 abschließen, 8 stornieren (nach der Wartezeit, vor einem Code). |
| getActiveActivations | Keine | {"status":"success","activeActivations":[…]} | Deine noch aktiven Nummern. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | Preis und Bestand nach Land und Dienst. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | Bestand pro Dienst für ein Land. |
| getCountries | Keine | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | Länderliste mit IDs. |
| getServicesList | Keine | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | Dienstcodes und Namen. |
setStatus Werte
- 1 · Nummer an den Dienst gesendet, warte auf SMS
- 3 · Weiteren Code an dieselbe Nummer anfordern
- 6 · Aktivierung abschließen
- 8 · Stornieren und erstatten (noch kein Code)
Zeitvorgaben
Nummern sind standardmäßig 20 Minuten aktiv. Eine Stornierung ist 120 Sekunden nach dem Kauf möglich (früher liefert EARLY_CANCEL_DENIED). Ohne Code wird die Aktivierung bei Ablauf automatisch erstattet. Ratenlimit: 300 Anfragen pro Minute pro Schlüssel.
Fehler
Webhook
Lege unter Konto eine Webhook-URL fest, und wir senden jeden empfangenen Code per POST als JSON dorthin, mit zwei Wiederholungen, falls dein Server nicht mit 2xx antwortet.
POST https://your-server/webhook
{ "activationId": 1042, "service": "tg", "country": "id", "phone": "6281244739021",
"code": "48213", "text": "Telegram code: 48213 …", "receivedAt": "2026-10-09T03:12:44.000Z" }