API

SMS-Aktivierungs-API

Kaufen Sie Nummern und lesen Sie Codes aus Ihren eigenen Skripten. Die API verwendet das gängige SMS-Aktivierungsformat, sodass die meisten bestehenden Clients durch Änderung der Basisadresse und des Schlüssels funktionieren.

Erstellen Sie Ihren API-Schlüssel auf der API-Schlüssel-Seite der Konsole. Er wird nur einmal angezeigt.

API-Schlüssel erhalten Registrieren

Basisadresse und Schlüssel

Senden Sie GET- oder POST-Anfragen an die Basisadresse mit api_key und action. Erstellen Sie den Schlüssel auf der API-Schlüssel-Seite der Konsole; er wird einmalig angezeigt.

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

Servicecodes sind die Namen auf unseren Service-Seiten (z.B. whatsapp, telegram, google). Ländercodes sind ISO-Codes in Kleinbuchstaben (us, gb, in). Limit: 300 Anfragen pro Minute pro Schlüssel. Jede Aktivierung hat ein 20-minütiges Fenster, wie in der Konsole.

getBalance

Ihr Guthaben in USD.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance

ACCESS_BALANCE:12.50

getServicesList

Servicecodes, die Sie kaufen können (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

Ländercodes (ISO, Kleinbuchstaben) und Vorwahlen (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries

{"us":{"name":"United States","dial":"1"}}

getPrices

Preise in USD und Lagerbestände pro Land und Dienst. Beide Filter sind optional.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us

{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

Kauft eine Aktivierung. Gibt die Aktivierungs-ID und die Nummer mit Ländercode zurück.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us

ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

STATUS_WAIT_CODE (noch kein Code), STATUS_OK:<code>, STATUS_WAIT_RETRY:<letzter Code> (erneuter Code angefordert), STATUS_CANCEL (storniert oder erstattet).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB

STATUS_OK:482913

setStatus

status=1 bereit (ACCESS_READY), 3 weiterer Code (ACCESS_RETRY_GET), 6 abschließen (ACCESS_ACTIVATION), 8 stornieren mit voller Rückerstattung, wenn kein Code ankam (ACCESS_CANCEL).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

ACCESS_RETRY_GET

Typischer Ablauf

getNumber mit Service und Land. Speichern Sie die ID.
Geben Sie die Nummer in der App ein und fordern Sie die SMS an.
Rufen Sie getStatus alle 5 bis 10 Sekunden auf, bis STATUS_OK.
Brauchen Sie eine weitere SMS? setStatus 3, dann getStatus erneut. Fertig: setStatus 6.
Kein Code? setStatus 8 storniert mit voller Rückerstattung. Ohne Aufruf erfolgt die Rückerstattung automatisch, wenn das Fenster endet.

Fehler

BAD_KEY	Fehlender oder falscher API-Schlüssel.
BAD_ACTION	Unbekannte Aktion.
BAD_SERVICE	Unbekannter Servicecode.
BAD_COUNTRY	Der Service wird in diesem Land nicht verkauft.
NO_BALANCE	Nicht genug Guthaben.
NO_NUMBERS	Momentan keine Nummer verfügbar. Versuchen Sie es später erneut.
NO_ACTIVATION	Unbekannte Aktivierungs-ID oder nicht Ihre.
EARLY_CANCEL_DENIED	Ein Code ist bereits angekommen, daher kann die Aktivierung nicht storniert werden.
TOO_MANY_REQUESTS	Mehr als 300 Anfragen in einer Minute.
NO_ACTIVATIONS	20 Aktivierungen sind bereits offen.