SMS-Empfangs-API

Kaufen Sie Nummern und lesen Sie Bestätigungscodes über eine JSON-API. Ohne Ausweisprüfung, Zahlung in Kryptowährung.

REST · JSONOpenAPI 3.1 OpenAPI-Spezifikation →

Wie ist die API aufgebaut?

1. Legen Sie ein Konto an und sichern Sie die zurückgegebene Phrase. Sie ist der einzige Zugang und lässt sich nicht zurücksetzen.
2. Legen Sie eine Aufladung an, senden Sie Kryptowährung und warten Sie auf die Gutschrift.
3. Kaufen Sie eine Nummer für den gewünschten Dienst und das Land — das Guthaben wird sofort belastet.
4. Fragen Sie die SMS mit dem Code ab. Kommt bis zum Ablauf der Bestellung kein Code, wird automatisch erstattet.

Einmal aufladen, oft kaufen: eine Aufladung reicht für so viele Nummern, wie das Guthaben zulässt, nur der erste Kauf wartet also auf eine Bestätigung.

Authentifizierung

Übergeben Sie die Kontophrase als Bearer-Token. Es gibt weder einen separaten API-Schlüssel noch einen Login-Aufruf — die Phrase ist die Zugangsberechtigung.

Authorization: Bearer YOUR-SEED-PHRASE

Die Katalog-Endpunkte brauchen überhaupt keine Authentifizierung, Dienste, Länder und Preise lassen sich also schon vor dem Anlegen eines Kontos ansehen. Alles rund um Geld und Bestellungen verlangt den Header.

Basisadresse

Alle Endpunkte sind relativ zu:

https://www.otpdrop.com/api/v1

Antworten kommen als JSON. POST-Bodies werden als application/json oder application/x-www-form-urlencoded angenommen.

Fehler

Bei einem Fehlschlag kommt ein Status außerhalb von 2xx und ein einzelnes Fehlerobjekt zurück.

{
  "error": {
    "code": "invalid_request",
    "message": "unknown service: \"whatsap\""
  }
}

Häufige Meldungen bei 422:

Gibt es Ratenbegrenzungen?

Es gibt keine veröffentlichte Quote und auch keinen API-Schlüssel, den man drosseln könnte — aber Endpunkte in einer Schleife aufzurufen, ist nicht kostenlos. Zwei davon sind zum Abfragen gedacht und verlangen besondere Sorgfalt.

Verkehr, der wie ein Angriff aussieht, wird vorgelagert blockiert, ohne höfliches 429. Haben Sie einen berechtigten Grund, häufiger abzufragen, schreiben Sie uns vorher über die Kontaktseite.

Wie sieht eine fertige Integration aus?

Vom Konto bis zum Code sind es sechs Aufrufe. Alles Folgende ist echt: einfügen und ausführen.

# 1. Konto anlegen und Phrase sichern
SEED=$(curl -s -X POST https://www.otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Aufladen — senden Sie coin_amount an die zurückgegebene Adresse
curl -s -X POST https://www.otpdrop.com/api/v1/topups \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"amount_usd": 25, "coin": "USDT"}'

# 3. Abfragen, bis die Aufladung gutgeschrieben ist
curl -s https://www.otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Vor dem Kauf den Preis prüfen
curl -s 'https://www.otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Kaufen — es wird abgebucht, die Nummer kommt sofort
ORDER=$(curl -s -X POST https://www.otpdrop.com/api/v1/orders \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"service": "telegram", "country": "us"}' | jq -r .order_id)

# 6. Code abfragen
until curl -s https://www.otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

Dieselbe Abfolge in Python, ohne Shell:

import time, requests

API = "https://www.otpdrop.com/api/v1"
seed = requests.post(f"{API}/accounts").json()["seed"]
auth = {"Authorization": f"Bearer {seed}"}

topup = requests.post(f"{API}/topups", headers=auth,
                      json={"amount_usd": 25, "coin": "USDT"}).json()
print("send", topup["coin_amount"], topup["coin"], "to", topup["address"])

while requests.get(f"{API}/topups/{topup['topup_id']}",
                   headers=auth).json()["status"] != "credited":
    time.sleep(15)

order = requests.post(f"{API}/orders", headers=auth,
                      json={"service": "telegram", "country": "us"}).json()
print("number:", order["phone"])

while True:
    sms = requests.get(f"{API}/orders/{order['order_id']}/sms",
                       headers=auth).json()
    if sms["arrived"]:
        print("code:", sms["code"])
        break
    time.sleep(4)

MCP-Server

Dieselben Operationen gibt es über das Model Context Protocol unter https://www.otpdrop.com/mcp — als elf Werkzeuge. So fügen Sie ihn Claude Code hinzu:

claude mcp add --transport http otpdrop https://www.otpdrop.com/mcp

Einrichtung und die vollständige Werkzeugliste stehen auf der Seite für Agenten.

Beschreibungsdateien

Maschinenlesbare Beschreibungen des Dienstes, alle ohne Authentifizierung abrufbar.

Häufige Fragen

Braucht die API von OTPDrop einen Schlüssel?

Nein. Es gibt nichts zu beantragen und keine Freigabe. Die Zugangsdaten sind die Kontophrase, übergeben als Bearer-Token — und die Katalog-Endpunkte brauchen nicht einmal die.

Was kostet die API von OTPDrop?

Nichts über die Nummern hinaus. Kein Abonnement, keine Abrechnung pro Aufruf, kein Mindestvolumen — es gelten dieselben Preise wie auf der Website.

Mit welchen Programmiersprachen funktioniert die API?

Mit jeder, die eine HTTPS-Anfrage stellen kann. Es ist gewöhnliches JSON über HTTP mit einem Bearer-Header: kein SDK zu installieren und nichts mit unseren Releases abzugleichen.

Was passiert, wenn die SMS mit dem Code nicht ankommt?

Die Bestellung erstattet sich bei Ablauf selbst aufs Guthaben; früher abbrechen können Sie über die Website. Sie zahlen für gelieferte Codes, nicht für Versuche.

Sind REST-API und MCP-Server dasselbe?

Ja, mit Absicht. Jeder REST-Endpunkt ist die Übersetzung eines MCP-Werkzeugaufrufs, sie können also nicht auseinanderlaufen: das eine zu ändern heißt, beides zu ändern. Nehmen Sie, was Ihrem Client besser passt.

Kann man die API testen, ohne etwas auszugeben?

Katalog, Preisabfrage und Kontoanlage sind kostenlos, der Großteil einer Integration lässt sich also vor jeder Aufladung schreiben und prüfen. Geld kostet nur der Kauf.