MyVendis API

Аренда номеров для приёма SMS. API совместим с SMS-Activate: если ваш софт работает с handler_api.php, достаточно заменить адрес и ключ.

Во все запросы передавайте api_key и action. Ключ выдаёт администратор. Номер живёт 20 минут с момента выдачи.

Оплата

Вы платите только за номера, на которые пришла SMS. При выдаче номера цена резервируется на балансе. Списание происходит только когда на номер пришла первая SMS. Если SMS не пришла (отмена или истечение 20 минут), резерв возвращается полностью. Повторные SMS на тот же номер бесплатны.

Порядок работы

1. Проверьте наличие: getNumbersStatus или getPrices.
2. Возьмите номер: getNumber. Вы получите ID активации и номер.
3. Опрашивайте getStatus каждые 3–5 секунд, пока не придёт STATUS_OK:код.
4. Нужен ещё код на тот же номер: setStatus со status=3.
5. Завершите: setStatus со status=6 (успех) или status=8 (отмена, если SMS не пришла).

GETgetBalance

Доступный баланс в USD.

https://myvendis.net/stubs/handler_api.php?action=getBalance&api_key=KEY

ACCESS_BALANCE:12.50

GETgetNumbersStatus

Количество доступных номеров по сервисам для страны.

{"tg_0":"50","go_0":"50","fb_0":"50"}

Суффикс _0 означает любого оператора.

GETgetPrices

Цены и количество. Без параметров возвращает все страны и сервисы.

{"16":{"go":{"cost":0.15,"count":50},"fb":{"cost":0.12,"count":50}}}

GETgetCountries

{"16":{"id":16,"eng":"United Kingdom","rus":"United Kingdom","phoneCode":"44","visible":1,"retry":1,"rent":0,"multiService":0}}

ID стран совпадают с SMS-Activate (16 — Великобритания, 86 — Италия, 43 — Германия и т.д.).

GETgetServicesList

{"status":"success","services":[{"code":"go","name":"Google"},{"code":"fb","name":"Facebook"}]}

GETgetOperators

{"status":"success","countryOperators":{"16":["any"]}}

Сейчас доступен только оператор any: подбор оператора выполняется автоматически.

GETgetNumber

Выдаёт номер. Время ответа обычно до 1–2 секунд.

https://myvendis.net/stubs/handler_api.php?action=getNumber&api_key=KEY&service=go&country=16

GETgetNumberV2

То же, что getNumber, но ответ в JSON.

{"activationId":1024,"phoneNumber":"447700900123","activationCost":0.15,"currency":840,
 "countryCode":"16","countryPhoneCode":"44","canGetAnotherSms":true,
 "activationTime":"2026-10-22 18:00:00","activationEndTime":"2026-10-22 18:20:00","activationOperator":"any"}

GETgetStatus

GETgetFullSms

Полный текст последней SMS.

FULL_SMS:Your verification code: 123456

GETsetStatus

Если действие недопустимо для текущего состояния, ответ BAD_STATUS.

GETgetActiveActivations

{"status":"success","activeActivations":[{"activationId":"1024","serviceCode":"go","phoneNumber":"447700900123",
 "activationCost":"0.15","activationStatus":"STATUS_OK:123456","smsCode":["123456"],
 "activationTime":"2026-10-22 18:00:00","countryCode":"16"}]}

Ошибки

Примеры кода

cURL

curl 'https://myvendis.net/stubs/handler_api.php?action=getNumber&api_key=KEY&service=go&country=16'
curl 'https://myvendis.net/stubs/handler_api.php?action=getStatus&api_key=KEY&id=1024'

Python

import time, requests

API = "https://myvendis.net/stubs/handler_api.php"
KEY = "ВАШ_КЛЮЧ"

def call(**params):
    return requests.get(API, params={"api_key": KEY, **params}, timeout=15).text

r = call(action="getNumber", service="go", country=16)
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, act_id, phone = r.split(":")
print("номер", phone)

for _ in range(240):  # до 20 минут
    st = call(action="getStatus", id=act_id)
    if st.startswith("STATUS_OK"):
        print("код", st.split(":", 1)[1])
        call(action="setStatus", id=act_id, status=6)
        break
    if st == "STATUS_CANCEL":
        break
    time.sleep(5)
else:
    call(action="setStatus", id=act_id, status=8)

Go

q := url.Values{"api_key": {key}, "action": {"getNumber"}, "service": {"go"}, "country": {"16"}}
resp, err := http.Get("https://myvendis.net/stubs/handler_api.php?" + q.Encode())
if err != nil { return err }
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body) // ACCESS_NUMBER:1024:447700900123