Die manuelle Kontoregistrierung ist der Engpass jedes skalierbaren Betriebs. Bei 100 und mehr Registrierungen pro Tag werden die Personalkosten zum größten Kostenfaktor. Eine API für virtuelle Nummern ist die Brücke vom manuellen zum automatischen Ablauf: Das Skript ruft eine Nummer ab, empfängt die SMS, liest den Code aus und schließt die Registrierung ohne menschliches Zutun ab.

Architektur der automatisierten Registrierung

Grundlegender Ablauf

Jede automatische Registrierung durchläuft die folgenden Schritte:

  1. Das Skript fordert über die API eine virtuelle Nummer an (mit Angabe von Dienst und Land)
  2. Der Dienst gibt die Nummer und die Aktivierungs-ID zurück
  3. Das Skript trägt die Nummer in das Registrierungsformular des Zieldienstes ein
  4. Der Zieldienst sendet eine SMS mit dem OTP-Code
  5. Das Skript fragt per Polling über die API die eingehenden SMS ab
  6. Die API liefert den Code aus der SMS zurück
  7. Das Skript gibt den Code ein und schließt die Registrierung ab
  8. Das Skript gibt die Nummer frei (oder wartet, bis sie abläuft)

Arbeit mit der turbon-API: die wichtigsten Endpunkte

Nummer abrufen

Der erste Schritt ist die Anfrage einer verfügbaren Nummer für den gewünschten Dienst und das gewünschte Land:

GET /api/getNumber?api_key=YOUR_KEY&service=telegram&country=ru Antwort: { "status": "success", "id": 12345678, "phone": "79991234567" }

Auf die SMS warten

Nachdem die Nummer an den Zieldienst übermittelt wurde, wird per Polling der Code abgerufen:

GET /api/getStatus?api_key=YOUR_KEY&id=12345678 Antwort (Wartezustand): {"status": "STATUS_WAIT_CODE"} Antwort (Code erhalten): {"status": "STATUS_OK", "code": "12345"}

Nutzung bestätigen

GET /api/setStatus?api_key=YOUR_KEY&id=12345678&status=6 # status=6 — melden, dass die SMS eingegangen und alles in Ordnung ist

Implementierungsbeispiele

Python: Basisklasse für die Arbeit mit der API

import requests import time class TurbonAPI: BASE_URL = "https://turbon.rent/api" def __init__(self, api_key): self.api_key = api_key def get_number(self, service, country="ru"): r = requests.get(f"{self.BASE_URL}/getNumber", params={ "api_key": self.api_key, "service": service, "country": country }) data = r.json() if data["status"] == "success": return data["id"], data["phone"] raise Exception(f"Failed to get number: {data}") def wait_sms(self, activation_id, timeout=120, interval=5): deadline = time.time() + timeout while time.time() < deadline: r = requests.get(f"{self.BASE_URL}/getStatus", params={ "api_key": self.api_key, "id": activation_id }) data = r.json() if data["status"] == "STATUS_OK": return data["code"] if "CANCEL" in data["status"]: raise Exception("Activation cancelled") time.sleep(interval) raise TimeoutError(f"SMS not received in {timeout}s") def confirm(self, activation_id): requests.get(f"{self.BASE_URL}/setStatus", params={ "api_key": self.api_key, "id": activation_id, "status": 6 }) # Verwendung: turbon = TurbonAPI("your_api_key") act_id, phone = turbon.get_number("telegram") # ... Registrierung bei Telegram mit der Nummer phone ... code = turbon.wait_sms(act_id) # ... Eingabe des Codes code ... turbon.confirm(act_id)

JavaScript/Node.js: asynchrone Variante

const axios = require('axios'); async function getNumber(apiKey, service, country = 'ru') { const { data } = await axios.get('https://turbon.rent/api/getNumber', { params: { api_key: apiKey, service, country } }); if (data.status !== 'success') throw new Error(data.status); return { id: data.id, phone: data.phone }; } async function waitSms(apiKey, id, timeout = 120000) { const deadline = Date.now() + timeout; while (Date.now() < deadline) { await new Promise(r => setTimeout(r, 5000)); const { data } = await axios.get('https://turbon.rent/api/getStatus', { params: { api_key: apiKey, id } }); if (data.status === 'STATUS_OK') return data.code; if (data.status.includes('CANCEL')) throw new Error('Cancelled'); } throw new Error('Timeout'); }

Parallele Registrierung

Worker-Pool-Muster

Für die parallele Registrierung von 100 Konten wird das Worker-Pool-Muster verwendet: N Worker arbeiten gleichzeitig, und jeder durchläuft den vollständigen Registrierungszyklus. Bei N=10 verkürzt sich die Zeit für die Registrierung von 100 Konten auf ein Zehntel.

from concurrent.futures import ThreadPoolExecutor import time def register_account(turbon, service, registrar): act_id, phone = turbon.get_number(service) registrar.start_registration(phone) code = turbon.wait_sms(act_id) account = registrar.complete_registration(code) turbon.confirm(act_id) return account # Paralleler Start with ThreadPoolExecutor(max_workers=10) as executor: futures = [ executor.submit(register_account, turbon, "telegram", registrar) for _ in range(100) ] accounts = [f.result() for f in futures]

Fehlerbehandlung und Retry

Typische Fehler

FehlerUrsacheLösung NO_NUMBERSKeine verfügbaren Nummern für Dienst/LandRetry nach 30–60 Sek. oder Länderwechsel STATUS_CANCELSMS nicht eingegangen, Aktivierung abgebrochenNeue Nummer abrufen, Vorgang wiederholen BANNEDAPI-Konto gesperrtGuthaben und Limits prüfen TimeoutErrorSMS kam nach Ablauf des Timeouts anTimeout erhöhen, Retry hinzufügen

Exponential Backoff

Bei NO_NUMBERS-Fehlern sollten Sie die API nicht mit Anfragen überfluten, sondern Pausen mit wachsendem Intervall einlegen: 5 s → 10 s → 20 s → 40 s. Das verringert die Last und erhöht die Chance, bei hoher Nachfrage eine Nummer zu erhalten.

Integration mit einem Antidetect-Browser

Playwright oder Selenium startet ein Browserprofil → das Skript ruft über die turbon-API eine Nummer ab → trägt die Nummer per Browser-Automatisierung in das Formular ein → empfängt den Code über die API → gibt ihn im Browser ein. Ein vollständiger Zyklus ohne menschliches Zutun.

Wichtig ist, dass zwischen dem Abruf der Nummer und der Eingabe des SMS-Codes eine Verzögerung von 5–30 Sekunden liegt (Nachahmung eines echten Nutzers, der die SMS „liest“). Ohne Verzögerung erkennen manche Plattformen die Automatisierung.

Best Practices bei der Automatisierung

  • Bestätigen Sie die Nutzung der Nummer immer (status=6) — das hilft, die Qualität des Pools zu verbessern
  • Fordern Sie keine Nummer an, solange das Registrierungsformular nicht zur Eingabe bereit ist — die Nummer kann sonst ablaufen
  • Protokollieren Sie jede Aktivierung samt Ergebnis — für die Analyse der Erfolgsquote nach Diensten
  • Verwenden Sie für verschiedene Plattformen unterschiedliche Länder — das verringert erkennbare Muster
  • Überschreiten Sie nicht die angemessene Anfragefrequenz an die API — beachten Sie die Rate Limits

Fazit

Die Automatisierung der Registrierung über eine API für virtuelle Nummern ist der Übergang von manueller Arbeit zu einem skalierbaren Prozess. 10 Zeilen Code ersetzen 10 Minuten manuelle Arbeit eines Operators. turbon.rent bietet eine API zum automatischen Abrufen von Nummern, zum SMS-Empfang und zur Verwaltung von Aktivierungen — alles, was Sie für die Integration in Ihre Skripte und Pipelines brauchen.