API do odbioru SMS

Kupuj numery i odczytuj kody weryfikacyjne przez API JSON. Bez kontroli tożsamości, płatność kryptowalutą.

REST · JSONOpenAPI 3.1 Specyfikacja OpenAPI →

Jak zorganizowane jest API?

1. Utwórz konto i zachowaj zwróconą frazę. To jedyny dostęp i nie da się go zresetować.
2. Utwórz doładowanie, wyślij kryptowalutę i poczekaj na zaksięgowanie.
3. Kup numer dla wybranego serwisu i kraju — saldo zostaje pobrane od razu.
4. Odpytaj o SMS z kodem. Jeśli żaden kod nie dotrze przed wygaśnięciem zamówienia, pieniądze wracają automatycznie.

Doładuj raz, kupuj często: jedno doładowanie pokrywa tyle numerów, na ile pozwala saldo, więc tylko pierwszy zakup czeka na potwierdzenie.

Uwierzytelnianie

Przekaż frazę konta jako token bearer. Nie ma osobnego klucza API ani wywołania logowania — fraza jest identyfikatorem.

Authorization: Bearer YOUR-SEED-PHRASE

Punkty końcowe katalogu nie wymagają uwierzytelniania: serwisy, kraje i ceny można więc przeglądać jeszcze przed założeniem konta. Wszystko, co dotyczy pieniędzy i zamówień, wymaga nagłówka.

Adres bazowy

Wszystkie punkty końcowe są względne wobec:

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

Odpowiedzi są w formacie JSON. Treści POST przyjmujemy jako application/json albo application/x-www-form-urlencoded.

Błędy

W razie niepowodzenia zwracamy status spoza zakresu 2xx wraz z jednym obiektem błędu.

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

Częste komunikaty przy 422:

Czy są limity zapytań?

Nie publikujemy żadnych limitów i nie ma klucza API, który dałoby się przydusić — ale wywoływanie punktów końcowych w pętli nie jest darmowe. Dwa z nich są przeznaczone do odpytywania w pętli i wymagają szczególnej uwagi.

Ruch przypominający atak zablokujemy wcześniej, bez uprzejmego 429. Jeśli masz uzasadniony powód, by odpytywać częściej, napisz do nas najpierw przez stronę kontaktu.

Jak wygląda pełna integracja?

Od konta do kodu — sześć wywołań. Wszystko poniżej jest prawdziwe: wklej i uruchom.

# 1. Utwórz konto i zachowaj frazę
SEED=$(curl -s -X POST https://www.otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Doładuj — wyślij coin_amount na zwrócony adres
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. Odpytuj, aż doładowanie zostanie zaksięgowane
curl -s https://www.otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Sprawdź cenę przed zakupem
curl -s 'https://www.otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Kup — saldo zostaje pobrane, numer wydany od razu
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. Odpytuj o kod
until curl -s https://www.otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

Ta sama sekwencja w Pythonie, bez powłoki:

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)

Serwer MCP

Te same operacje są dostępne przez Model Context Protocol pod https://www.otpdrop.com/mcp, w postaci jedenastu narzędzi. Aby dodać go do Claude Code:

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

Konfigurację i pełną listę narzędzi znajdziesz na stronie dla agentów.

Pliki odkrywania

Czytelne maszynowo opisy serwisu, wszystkie serwowane bez uwierzytelniania.

Częste pytania

Czy do API OTPDrop potrzebny jest klucz?

Nie. Nie ma o co prosić i nie ma żadnej weryfikacji. Identyfikatorem jest fraza konta przekazywana jako token bearer — a punkty końcowe katalogu nie potrzebują nawet tego.

Ile kosztuje API OTPDrop?

Nic ponad same numery. Bez abonamentu, bez rozliczania za wywołanie, bez minimalnego wolumenu — ceny są takie same jak na stronie.

Z jakimi językami programowania działa API?

Z każdym, który potrafi wykonać żądanie HTTPS. To zwykły JSON po HTTP z nagłówkiem bearer: nie ma SDK do instalowania ani niczego, co trzeba synchronizować z naszymi wersjami.

Co się dzieje, gdy SMS nie dotrze?

Zamówienie zwraca się samo na saldo w chwili wygaśnięcia; możesz je też anulować wcześniej ze strony. Płacisz za dostarczone kody, a nie za próby.

Czy API REST i serwer MCP to to samo?

Tak, celowo. Każdy punkt końcowy REST jest tłumaczeniem wywołania narzędzia MCP, więc nie mogą się rozejść: zmiana jednego to zmiana drugiego. Wybierz to, co lepiej pasuje do Twojego klienta.

Czy można przetestować API, nic nie wydając?

Katalog, wyliczanie ceny i tworzenie konta są darmowe: większość integracji można więc napisać i sprawdzić przed jakimkolwiek doładowaniem. Pieniądze kosztuje wyłącznie zakup.