API pro příjem SMS

Kupujte čísla a čtěte ověřovací kódy přes JSON API. Bez kontroly totožnosti, platba kryptoměnou.

REST · JSONOpenAPI 3.1 Specifikace OpenAPI →

Jak je API uspořádané?

1. Založte účet a uschovejte vrácenou frázi. Je to jediný přístup a nelze ji resetovat.
2. Vytvořte dobití, odešlete kryptoměnu a počkejte na připsání.
3. Kupte číslo pro požadovanou službu a zemi — zůstatek se strhne ihned.
4. Dotažte se na SMS s kódem. Pokud kód nedorazí do vypršení objednávky, peníze se vrátí automaticky.

Dobijte jednou, nakupujte často: jedno dobití pokryje tolik čísel, kolik zůstatek dovolí, takže na potvrzení čeká jen první nákup.

Přihlášení

Frázi účtu předávejte jako bearer token. Není tu žádný samostatný klíč API ani přihlašovací volání — fráze je přihlašovací údaj.

Authorization: Bearer YOUR-SEED-PHRASE

Endpointy katalogu žádné přihlášení nevyžadují: služby, země i ceny si tedy prohlédnete ještě před založením účtu. Vše, co se týká peněz a objednávek, hlavičku vyžaduje.

Základní adresa

Všechny endpointy jsou relativní vůči:

https://otpdrop.com/api/v1

Odpovědi jsou v JSON. Těla POST přijímáme jako application/json nebo application/x-www-form-urlencoded.

Chyby

Při selhání vracíme stav mimo 2xx spolu s jediným chybovým objektem.

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

Časté zprávy u 422:

Platí nějaké limity volání?

Žádnou kvótu nezveřejňujeme a neexistuje klíč API, který by se dal škrtit — ale volat endpointy ve smyčce není zadarmo. Dva z nich jsou určené k opakovaným dotazům a zaslouží zvláštní pozornost.

Provoz, který vypadá jako útok, zablokujeme dřív, bez zdvořilého 429. Pokud máte oprávněný důvod dotazovat se častěji, napište nám nejdřív přes kontaktní stránku.

Jak vypadá kompletní integrace?

Od účtu ke kódu šest volání. Vše níže je skutečné: vložte a spusťte.

# 1. Založit účet a uschovat frázi
SEED=$(curl -s -X POST https://otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Dobít — odešlete coin_amount na vrácenou adresu
curl -s -X POST https://otpdrop.com/api/v1/topups \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"amount_usd": 25, "coin": "USDT"}'

# 3. Dotazovat se, dokud se dobití nepřipíše
curl -s https://otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Ověřit cenu před nákupem
curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Koupit — zůstatek se strhne, číslo se vydá ihned
ORDER=$(curl -s -X POST https://otpdrop.com/api/v1/orders \
  -H "Authorization: Bearer \$SEED" \
  -H 'content-type: application/json' \
  -d '{"service": "telegram", "country": "us"}' | jq -r .order_id)

# 6. Dotazovat se na kód
until curl -s https://otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

Tatáž posloupnost v Pythonu, bez shellu:

import time, requests

API = "https://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)

Server MCP

Tytéž operace jsou dostupné přes Model Context Protocol na https://otpdrop.com/mcp, a to jako jedenáct nástrojů. Přidání do Claude Code:

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

Nastavení a úplný seznam nástrojů najdete na stránce pro agenty.

Soubory pro objevování

Strojově čitelné popisy služby, všechny dostupné bez přihlášení.

Časté dotazy

Je pro API OTPDrop potřeba klíč?

Ne. Není o co žádat a nic se neschvaluje. Přihlašovacím údajem je fráze účtu předaná jako bearer token — a endpointy katalogu ji ani nepotřebují.

Kolik API OTPDrop stojí?

Nic nad rámec samotných čísel. Žádné předplatné, žádné účtování za volání, žádný minimální objem — platí ceny z webu.

S jakými programovacími jazyky API funguje?

S jakýmkoli, který umí odeslat požadavek HTTPS. Je to běžný JSON přes HTTP s hlavičkou bearer: žádné SDK k instalaci a nic, co by se muselo držet krok s našimi verzemi.

Co se stane, když SMS nedorazí?

Objednávka se při vypršení sama vrátí na zůstatek; můžete ji také zrušit dřív z webu. Platíte za doručené kódy, ne za pokusy.

Jsou REST API a server MCP totéž?

Ano, záměrně. Každý endpoint REST je překladem jednoho volání nástroje MCP, takže se nemohou rozejít: změnit jedno znamená změnit druhé. Vyberte si to, co se vašemu klientovi hodí víc.

Lze API vyzkoušet, aniž bych něco utratil?

Katalog, výpočet ceny i založení účtu jsou zdarma: podstatnou část integrace tedy napíšete a ověříte ještě před prvním dobitím. Peníze stojí až nákup.