SMS-Verifizierungs-API

Nummernkauf, Code-Abfrage und Stornierung mit je einer HTTP-Anfrage. Das in der Branche für virtuelle Nummern verbreitete handler_api-Format verbindet sich sofort mit Registrierungsprogrammen und Bots, Sie tragen nur Adresse und Schlüssel ein.

API-Schlüssel erhalten

Erstellen Sie nach dem Login im Menü API Ihres Kontos einen Schlüssel. Der Schlüssel wird nur einmal bei der Erstellung angezeigt, speichern Sie ihn sofort. Die API nutzt dasselbe Guthaben und dieselben Preise wie die Website.

Basis-URL

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

Wichtige Anfragen

actionAufgabenBeispielantwort
getBalanceGuthaben prüfenACCESS_BALANCE:12.50
getPrices&service=telegram&country=krPreise und verfügbare Nummern nach Dienst{"kr":{"telegram":{"cost":3.2,"count":7922}}}
getNumber&service=telegram&country=krNummer kaufenACCESS_NUMBER:ID:PHONE
getStatus&id=IDCode prüfenSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Nummer stornieren (vor dem Code, volle Erstattung)ACCESS_CANCEL
setStatus&id=ID&status=3Weiteren Code an dieselbe Nummer empfangenACCESS_RETRY_GET
setStatus&id=ID&status=6Nutzung beendenACCESS_ACTIVATION

Parameter

NamePflichtfeldBeschreibung
api_keyAlleIm Konto erstellter API-Schlüssel
actionAllegetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberDienstcode (z. B. telegram, whatsapp, google). Entspricht der Adresse der Dienstseite
countrygetNumberkr (koreanische 010-Nummer, Standard ist kr)
idgetStatus, setStatusVon getNumber zurückgegebene Nummern-ID (beginnt mit N-)
statussetStatus8 Stornieren, 3 Weiterer Code, 6 Abschließen, 1 Bereit

Antworttexte und Bedeutung

AntwortBedeutungGeld
ACCESS_NUMBER:ID:PHONENummer erhaltenDer Nummernpreis wird abgebucht
STATUS_WAIT_CODEWarten auf den CodeUnverändert
STATUS_OK:CODECode ist angekommenZahlung abgeschlossen
STATUS_WAIT_RETRY:CODEWarten auf den nächsten Code (frühere Codes bleiben sichtbar)Kein Aufpreis
STATUS_CANCELStorniert oder Zeit abgelaufenOhne Code erstattet
ACCESS_CANCELStorniertVolle Erstattung
ACCESS_RETRY_GETAuf einen weiteren Code an dieselbe Nummer wartenKein Aufpreis
ACCESS_ACTIVATIONNummer abgeschlossenUnverändert
NO_BALANCENach dem Aufladen sofort empfangenWird nicht abgebucht
NO_NUMBERSFür dieses Land ist gerade keine Nummer verfügbarWird nicht abgebucht
NO_ACTIVATIONSSie haben 20 offene NummernWird nicht abgebucht
EARLY_CANCEL_DENIEDNummern mit Code abschließen (6) statt stornierenUnverändert
BAD_KEYDer API-Schlüssel ist ungültigWird nicht abgebucht
BAD_SERVICE / BAD_COUNTRYDienst- oder Ländercode ist ungültigWird nicht abgebucht
NO_ACTIVATIONNummern-ID nicht gefundenUnverändert
TOO_MANY_REQUESTSLimit von 300 Anfragen pro Minute überschrittenWird nicht abgebucht

Beispiele nach Programmiersprache

import time, requests

BASE = "https://010sms.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="kr")
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)

So funktioniert es

  • Holen Sie mit getNumber eine Nummer, geben Sie sie im Registrierungsformular ein und rufen Sie dann alle 5 Sekunden getStatus auf.
  • STATUS_OK:Wenn der Code ankommt, geben Sie ihn ein und schließen mit setStatus 6 ab.
  • Kommt innerhalb von 20 Minuten kein Code, wird der Nummernpreis automatisch Ihrem Guthaben erstattet.
  • Bis zu 300 Anfragen pro Minute.
SMS-Verifizierungs-API | 010SMS