API за получаване на SMS

Купувайте номера и четете кодовете за потвърждение чрез JSON API. Без проверка на самоличността, плащане с криптовалута.

REST · JSONOpenAPI 3.1 Спецификация OpenAPI →

Как е устроено API?

1. Създайте сметка и запазете върнатата фраза. Това е единственият достъп и той е невъзстановим.
2. Създайте захранване, изпратете криптовалутата и изчакайте начисляването.
3. Купете номер за желаната услуга и държава — балансът се тегли веднага.
4. Запитайте за SMS с кода. Ако не пристигне код преди изтичането на поръчката, парите се връщат автоматично.

Захранвайте веднъж, купувайте често: едно захранване покрива толкова номера, колкото позволява балансът, тъй че само първата покупка чака потвърждение.

Удостоверяване

Подайте фразата на сметката като bearer токен. Няма нито отделен API ключ, нито извикване за вход — фразата е идентификаторът.

Authorization: Bearer YOUR-SEED-PHRASE

Крайните точки на каталога не изискват никакво удостоверяване: услуги, държави и цени се разглеждат следователно още преди да имате сметка. Всичко, което засяга пари и поръчки, изисква заглавката.

Основен адрес

Всички крайни точки са относителни спрямо:

https://otpdrop.com/api/v1

Отговорите са в JSON. Телата на POST се приемат като application/json или application/x-www-form-urlencoded.

Грешки

При неуспех се връща статус извън 2xx с един-единствен обект за грешка.

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

Чести съобщения при 422:

Има ли ограничения на честотата?

Не са публикувани квоти и няма API ключ, който да бъде забавен — но извикването на крайните точки в цикъл не е безплатно. Две от тях са направени да се запитват в цикъл и изискват особено внимание.

Трафик, който прилича на атака, ще бъде блокиран нагоре по веригата, без учтив 429. Ако имате законна причина да запитвате по-често, пишете ни първо през страницата за контакт.

Как изглежда една пълна интеграция?

От сметката до кода — шест извиквания. Всичко по-долу е истинско: поставете и изпълнете.

# 1. Създаване на сметка и запазване на фразата
SEED=$(curl -s -X POST https://otpdrop.com/api/v1/accounts | jq -r .seed)

# 2. Захранване — изпратете coin_amount на върнатия адрес
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. Запитване до начисляването на захранването
curl -s https://otpdrop.com/api/v1/topups/TOPUP_ID \
  -H "Authorization: Bearer \$SEED" | jq .status

# 4. Проверка на цената преди покупка
curl -s 'https://otpdrop.com/api/v1/quote?service=telegram&country=us'

# 5. Покупка — балансът се тегли, номерът се издава веднага
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. Запитване за кода
until curl -s https://otpdrop.com/api/v1/orders/\$ORDER/sms \
  -H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done

Същата последователност на Python, без шел:

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)

MCP сървър

Същите операции са достъпни през Model Context Protocol на https://otpdrop.com/mcp, под формата на единайсет инструмента. За да го добавите към Claude Code:

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

Настройката и пълният списък с инструменти са на страницата за агенти.

Файлове за откриване

Машинночетими описания на услугата, всички поднасяни без удостоверяване.

Често задавани въпроси

Нужен ли е ключ за API на OTPDrop?

Не. Няма какво да се заявява и няма одобрение. Идентификаторът е фразата на сметката, подадена като bearer токен — а крайните точки на каталога дори нямат нужда от нея.

Колко струва API на OTPDrop?

Нищо над самите номера. Нито абонамент, нито такса на повикване, нито минимален обем — цените са тези от сайта.

С кои езици за програмиране работи API?

С всеки език, който може да направи HTTPS заявка. Това е обикновен JSON по HTTP със заглавка bearer: няма SDK за инсталиране и няма какво да се сверява с нашите версии.

Какво става, ако SMS не пристигне?

Поръчката се възстановява сама в баланса при изтичането си; можете също да я отмените по-рано от сайта. Плащате за доставени кодове, а не за опити.

Едно и също ли са REST API и MCP сървърът?

Да, умишлено. Всяка REST крайна точка е превод на извикване на MCP инструмент, тъй че те не могат да се разминат: промяната на едното е промяна и на другото. Изберете това, което подхожда по-добре на вашия клиент.

Може ли API да се изпробва, без да се харчи нищо?

Каталогът, изчисляването на цена и създаването на сметка са безплатни: по-голямата част от една интеграция може да се напише и провери преди каквото и да е захранване. Само покупката струва пари.