NAV
shell python php

DOMAIN

$DOMAIN =

Начало работы

Все запросы должны идти на http://api1.$DOMAIN/stubs/handler_api.php

Для совместимости с уже существующим ПО, где нет нашего сервиса, но есть наш API

Для пользователей Windows

Добавьте строчку 88.99.223.62 domain в файл C:\Windows\System32\drivers\etc\hosts, замените domain на нужный домен, который используется в ПО

Для пользователей Linux

Добавьте строчку 88.99.223.62 domain в файл /etc/hosts, замените domain на нужный домен, который используется в ПО

В случае если ПО неработает

Скачайте корневой сертификат и установите его:

Windows

Linux

sudo mkdir /usr/share/ca-certificates/extra

sudo cp 5sim_rootCA.crt /usr/share/ca-certificates/extra/5sim_rootCA.crt

Номера

Запрос количества доступных номеров

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country"
import requests

api_key = 'Your token' country = 0

params = ( ('api_key', api_key), ('country', country), ('action', 'getNumbersStatus') )

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)

<?php

$api_key = 'Your token'; $ch = curl_init(); $country = 0; $action = 'getNumbersStatus';

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&country =' . $country . '&action=' . $action); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch); if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch);

Пример ответа

{
    "at_0":"330",
    "fb_0":"330",
    "gm_0":"323",
    "go_0":"323",
    "ig_0":"326",
    "mb_0":"330",
    "mm_0":"330",
    "ok_0":"330",
    "or_0":"315",
    "ot_0":"315",
    "qw_0":"327",
    "tg_0":"329",
    "tw_0":"330",
    "vi_0":"330",
    "vk_0":"292",
    "vr_0":"330",
    "wa_0":"330",
    "wb_0":"328",
    "we_0":"330",
    "ya_0":"203",
    "ym_0":"13"
}

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

Возвращает количество доступных номеров

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ
country number / string Нет Номер страны / Название страны

Список доступных стран

Ответ

Поле Тип Описание
serviceName_{0/1} string Название сервиса до черточки, после обозначение нужно ли включать переадресацию. 0 - не включать. 1 - включать
total string Количество доступных номеров

Заказ номера

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&forward=$forward&operator=$operator&country=$country"
import requests

api_key = 'Your token'
country = 0
service = 'hn'
forward = 0
operator = 'megafon'

params = (
    ('api_key', api_key),
    ('country', country),
    ('action', 'getNumber'),
    ('service', service),
    ('forward', forward),
    ('operator', operator)
)

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)
<?php

$api_key = 'Your token';
$ch = curl_init();
$country = 0;
$action = 'getNumbersStatus';
$service = 'hn';
$forward = 0;
$operator = 'megafon';

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&country =' . $country  . '&action=' . $action . '&service=' . $service . '&forward=' . $forward . '&operator=' . $operator);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&forward=$forward&operator=$operator&country=$country

Заказывает номер для определенного сервиса

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ
service string Да Сервис для заказа
forward number Нет Включение переадресации. 0 (не выполнять), 1 - (выполнять). По умолчанию равен 0
operator string Нет Название опреатора. Принимаемые значения: mts, beeline, any, где any - любой оператор). Необязательный параметр, по умолчанию равен any
country number / string Нет Номер страны / Название страны

Список доступных сервисов

Список доступных стран

Список доступных операторов

Ответы

Изменение статуса активации

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward"
import requests

api_key = 'Your token'
id = 1
status = 1
forward = 0

params = (
    ('api_key', api_key),
    ('id', id),
    ('action', 'setStatus'),
    ('status', status),
    ('forward', forward)
)

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)
<?php

$api_key = 'Your token';
$ch = curl_init();
$action = 'setStatus';
$id= 1;
$forward = 0;
$status = 1;

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&id =' . $id . '&action=' . $action . '&forward=' . $forward . '&status=' . $status);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

Изменяет статус активации номера

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ
id string Да ID активации
forward number Да / Нет Номер телефона на который нужно выполнить переадресацию. Обязательно, только если при getNumber был передан параметр forward=1
status string Нет Статус активации

Возможные статусы активации:

Ответы

Получить состояние активации

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id"
import requests

api_key = 'Your token'
id = 1

params = (
    ('api_key', api_key),
    ('id', id),
    ('action', 'getStatus')
)

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)
<?php

$api_key = 'Your token';
$ch = curl_init();
$action = 'getStatus';
$id= 1;

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&id =' . $id . '&action=' . $action);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Возвращает состояние активации

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ
id string Да ID активации

Ответы

Цены

Запрос цен

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices"
import requests

api_key = 'Your token'

params = ( ('api_key', api_key), ('action', 'getPrices') )

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)

<?php

$api_key = 'Your token'; $ch = curl_init(); $action = 'getPrices';

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&action=' . $action); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch); if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices

Возвращает цены товаров

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ

Ответ

Пример ответа

{
  "russia":{
    "telegram":{
      "beeline":{
        "cost":8,
        "count":0
      },
      "matrix":{
        "cost":8,
        "count":0
      },
      "megafon":{
        "cost":8,
        "count":0
      },
      "mts":{
        "cost":8,
        "count":0
      },
      "rostelecom":{
        "cost":8,
        "count":0
      },
      "tele2":{
        "cost":8,
        "count":0
      },
      "virtual15":{
        "cost":8,
        "count":0
      },
      "yota":{
        "cost":8,
        "count":0
      }
    }
  }
}

Запрос цен по стране

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=russia"
import requests

api_key = 'Your token'
country = 0

params = (
    ('api_key', api_key),
    ('country', country),
    ('action', 'getPrices')
)

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)
<?php

$api_key = 'Your token';
$ch = curl_init();
$country = 0;
$action = 'getPrices';

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&country =' . $country  . '&action=' . $action);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=russia

Возвращает цены товаров по стране

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ
country number / string Да Номер страны / Название страны

Список доступных стран

Ответы

Пример ответа

{
  "russia":{
    "1688":{
      "beeline":{
        "cost":4,
        "count":1260
      },
      "lycamobile":{
        "cost":4,
        "count":935
      },
      "matrix":{
        "cost":4,
        "count":0
      }
    }
  }
}

Запрос цены по товару

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices&service=vkontakte"
import requests

api_key = 'Your token'
service = 'vkontakte'

params = (
    ('api_key', api_key),
    ('action', 'getPrices'),
    ('service', service)
)

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)
<?php

$api_key = 'Your token';
$ch = curl_init();
$action = 'getPrices';
$service= 'vkontakte';

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&action=' . $action . '&service=' . $service);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices&service=vkontakte

Возвращает цены конкретному товару

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ
service string Да Название сервиса

Список доступных сервисов

Ответы

Пример ответа

{
  "telegram":{
    "afghanistan":{
      "virtual18":{
        "cost":4,
        "count":1260
      },
      "virtual23":{
        "cost":4,
        "count":935
      },
      "virtual4":{
        "cost":4,
        "count":0
      }
    }
  }
}

Запрос цены по стране и товару

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=russia&service=vkontakte"
import requests

api_key = 'Your token'
country = 0
service = 'vkontakte'

params = (
    ('api_key', api_key),
    ('country', country),
    ('service', service),
    ('action', 'getPrices')
)

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)
<?php

$api_key = 'Your token';
$ch = curl_init();
$action = 'getPrices';
$country = 0;
$service = 'vkontakte';

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&country  =' . $country  . '&action=' . $action . '&service  =' . $service);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=russia&service=vkontakte

Возвращает цены товаров по стране и конкретному товару

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ
service string Да Название сервиса
country number / string Да Номер страны / Название страны

Список доступных сервисов

Список доступных стран

Ответы

Пример ответа

{
  "russia":{
    "telegram":{
      "beeline":{
        "cost":8,
        "count":0
      },
      "matrix":{
        "cost":8,
        "count":0
      },
      "megafon":{
        "cost":8,
        "count":0
      },
      "mts":{
        "cost":8,
        "count":0
      },
      "rostelecom":{
        "cost":8,
        "count":0
      },
      "tele2":{
        "cost":8,
        "count":0
      },
      "virtual15":{
        "cost":8,
        "count":0
      },
      "yota":{
        "cost":8,
        "count":0
      }
    }
  }
}

Баланс

Запрос баланса

Пример запроса

curl "http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getBalance"
import requests

api_key = 'Your token'

params = ( ('api_key', api_key), ('action', 'getBalance') )

response = requests.get('http://api1.$DOMAIN/stubs/handler_api.php', params=params)

<?php

$api_key = 'Your token'; $ch = curl_init(); $action = 'getBalance';

curl_setopt($ch, CURLOPT_URL, 'http://api1.$DOMAIN/stubs/handler_api.php?api_key=' . $api_key . '&action=' . $action); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch); if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch);

GET / POST - http://api1.$DOMAIN/stubs/handler_api.php?api_key=$api_key&action=getBalance

Возвращает размер баланса

Параметры запроса

Поле Тип Обязательное Описание
api_key string Да API-ключ

Ответ

Страны

Доступные страны

Номер страны

Также можно использовать полное название страны:

Сервисы

Доступные сервисы

Также можно использовать полное имя сервиса:

Операторы

Доступные операторы