API für SMS-Verifizierung

Die SNSSIM-API behandelt den Kauf von Nummern, die Überprüfung von Codes, Stornierungen sowie die Abfrage von Guthaben und Preisen in einer einzigen HTTP-Anfrage. Da der branchenübliche handler_api-Ansatz verwendet wird, können Sie sich sofort verbinden, indem Sie nur die Adresse und den API-Schlüssel in Ihrem bestehenden Programm ändern.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Branchenstandard
handler_api

Branchenstandard

Pro API-Schlüssel
300 pro Minute

Pro API-Schlüssel

Land / Dienst
145 / 1,255

Land / Dienst

Automatische Rückerstattung bei fehlendem Code
20 Minuten

Automatische Rückerstattung bei fehlendem Code

Wie erhalte ich einen API-Schlüssel?

Erstellen Sie den Schlüssel nach der Anmeldung im API-Menü des Kontobereichs. Der Schlüssel wird nur einmal angezeigt, speichern Sie ihn sofort. Die API verwendet dasselbe Guthaben und dieselben Preise wie die Webseite.

Was ist die Basis-URL?

Alle Anfragen werden an dieselbe Adresse mit api_key und action als GET-Anfrage gesendet.

https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=...

Welche Anfragen kann ich senden?

7 verschiedene Anfragen möglich: Von Nummernkauf bis Codeabfrage, Stornierung und Guthabenabfrage.

actionAufgabeBeispielantwort
getBalanceGuthaben prüfenACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbPreise und verfügbare Nummern nach Dienst und Land{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbNummer kaufenACCESS_NUMBER:ID:PHONE
getStatus&id=IDCode prüfenSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Nummer stornieren (volle Rückerstattung bei nicht erhaltenem Code)ACCESS_CANCEL
setStatus&id=ID&status=3Zusätzlichen Bestätigungscode mit derselben Nummer empfangenACCESS_RETRY_GET
setStatus&id=ID&status=6Nutzung beendenACCESS_ACTIVATION

Anfrageparameter

NameErforderlichBeschreibung
api_keyAlleIm Kontobereich erstellter API-Schlüssel
actionAllegetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberDienstcode (z.B. telegram, whatsapp, google). Entspricht Werten auf der Diensteliste.
countrygetNumberLändercode mit 2 Buchstaben (z.B. gb, us, id)
idgetStatus, setStatusVon getNumber ausgegebene Nummern-ID (beginnt mit N)
statussetStatus8 Mal stornieren, 3 Mal Code erneut anfordern, 6 Mal beenden, 1 Mal vorbereiten

Antwortcodes und Bedeutung

Antworten erfolgen knapp. Guthabenabzug wird angezeigt.

AntwortBedeutungGeld
ACCESS_NUMBER:ID:PHONENummer erhaltenNummernpreis wird abgebucht
STATUS_WAIT_CODEWarte auf den CodeUnverändert
STATUS_OK:CODEDer Code ist daZahlung abgeschlossen
STATUS_WAIT_RETRY:CODEWarte auf weiteren Code (inkl. vorheriger).Ohne Aufpreis
STATUS_CANCELStorniert oder Zeit abgelaufenOhne Code erstattet
ACCESS_CANCELStorniertVolle Erstattung
ACCESS_RETRY_GETWarten auf erneuten Codeempfang mit derselben NummerOhne Aufpreis
ACCESS_ACTIVATIONNutzung der Nummer abgeschlossenUnverändert
NO_BALANCESofort nach dem Aufladen verfügbarKeine Abbuchung
NO_NUMBERSDerzeit können wir keine Nummern für dieses Land anbieten.Keine Abbuchung
NO_ACTIVATIONSSie haben 20 offene NummernKeine Abbuchung
EARLY_CANCEL_DENIEDWählen Sie „Beenden“ (6) für Nummern mit empfangenen Codes.Unverändert
BAD_KEYDer API-Schlüssel ist ungültigKeine Abbuchung
BAD_SERVICE / BAD_COUNTRYDienst- oder Landescode ungültigKeine Abbuchung
NO_ACTIVATIONNummern-ID nicht gefundenUnverändert
TOO_MANY_REQUESTSLimit von 300 Anfragen pro Minute überschrittenKeine Abbuchung

Wie erhalte ich Codes über die API?

4 Schritte: Nummer erhalten, eingeben, Code prüfen, abschließen.

  1. 1 Schritte

    Nummer erhalten

    Wählen Sie in getNumber den gewünschten Dienst und das Land, um eine Nummer zu erhalten.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 Schritte

    Nummer eingeben

    Geben Sie die gekaufte Nummer auf der Registrierungsseite oder im Programm ein.

    +44 7700 900123
  3. 3 Schritte

    Code prüfen

    Rufen Sie getStatus alle 5 Sekunden auf, um zu überprüfen, ob der Code eingetroffen ist.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 Schritte

    Beenden

    Nach Code-Eingabe mit setStatus 6 abschließen. Kein Code innerhalb von 20 Minuten? Automatische Erstattung.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Beispiele nach Sprache

Vollständiger Ablauf: Nummer erhalten, Code abwarten, abschließen. Sprache über Tab wechseln.

import time, requests

BASE = "https://snssim.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

API Häufige Fragen

Die API bietet Nummern aus 145 Ländern und 1,255 Diensten zum gleichen Preis wie auf der Webseite an.

Was ist eine SMS-Authentifizierungs-API?
Funktion zum Kauf von Nummern, Code-Empfang und Stornierung via HTTP-Anfragen. SNSSIM API nutzt den Branchenstandard handler_api.
Kann ich Programme, die ich auf anderen SMS-Bestätigungsseiten verwendet habe, weiterhin verwenden?
Programme mit handler_api-Methode können durch Änderung der Basis-URL und des API-Schlüssels sofort verbunden werden.
Gibt es separate API-Gebühren?
Kein Unterschied - API und Webseite nutzen dasselbe Guthaben und Preise.
Wie viele Anfragen sind möglich?
Pro API-Schlüssel sind maximal 300 Anfragen pro Minute möglich. Bei Überschreitung tritt der Fehler TOO_MANY_REQUESTS auf, und das Guthaben wird nicht belastet.
Werden über die API gekaufte Nummern erstattet?
Ja. Nicht erhaltene Codes werden innerhalb 20 Minuten automatisch erstattet - auch bei API-Käufen.
Wo kann ich einen API-Schlüssel erstellen?
Erstellen Sie den Schlüssel nach der Anmeldung im API-Menü des Kontobereichs. Der Schlüssel wird nur einmal angezeigt, speichern Sie ihn sofort.

Erstellen Sie einen API-Schlüssel und verbinden Sie sich sofort

Nach der Registrierung und Aufladung Ihres Guthabens können Sie auf der Kontoseite sofort einen API-Schlüssel generieren.

API für SMS-Verifizierung | SNSSIM