Покупка телефонного номера через API

✅Примечание:	Данный раздел предназначен для операторов, предоставляющих услуги связи и имеющих свою платформу.

Для подключения телефонных номеров операторы могут обращаться к платформе MCN Telecom посредством API.

Быстрый способ покупки телефонного номера через API

✅Примечание:	Телефонный номер, покупаемый описанным способом, должен быть российским. К нему автоматически будет применен тариф «По меню» с помесячной оплатой 249 руб./мес.

На главной странице Личного кабинета «Главное меню» в верхнем меню выберите пункт «API».
В левом меню выберите раздел «Методы API | Документация».
Раскройте группу методов «Работа с номерной емкостью» и вызовите метод «GET /account/{account_id}/did/get-grouped-free-numbers» (Выбрать список свободных номеров).

Для этого метода необходимо заполнить значения параметров:
- account_id — введите номер своего лицевого счета.
- ndcType — введите тип номера. Есть 2 типа номеров:1 — мобильные,2 — географические.
- cities — введите ID городов, в которых нужны номера.
- степень красивости — показатель красивости номера. Есть 6 степеней красивости:0 = ‘Стандартный’1 = ‘Бронзовый’2 = ‘Серебряный’3 = ‘Золотой’4 = ‘Платиновый’5 = ‘Эксклюзивный’. Чем выше степень красивости, тем дороже стоит номер.
Пример запроса (cURL):

curl -X GET "https://api.mcn.ru/v2/rest/account/123456789/did/get-grouped-free-numbers?ndcType=2&cities=643_495&beauti_level=1" \
-H "Authorization: Bearer your_api_token_here" \
-H "Accept: application/json"

Если вы не знаете ID городов, в которых нужно заказать номера, то переходите в метод «GET /account/{account_id}/did/countries/get-cities» (Получение списка городов в стране).

Для этого метода необходимо заполнить значения параметров:
- account_id — введите номер своего лицевого счета;
- country_id — введите коды станы (Россия — 643).
- with_ndcs — введите значение «1» для получения всех префиксов.
Пример запроса:

    curl -X GET "https://api.mcn.ru/v2/rest/account/123456789/did/countries/get-cities?country_id=643&with_ndcs=1" \
  -H "Authorization: Bearer your_api_token_here" \
  -H "Accept: application/json"

⚠️Внимание!	Теперь не нужно вызывать метод «GET /account/{account_id}/billing/get-tariffs» для получения тарифа, т.к. все данные мы получаем из ответа метода «GET /account/{account_id}/did/get-grouped-free-numbers» (Выбрать список свободных номеров).

tariff_period_id — тарифный план для номера. Возможные значения.
price_setup — стоимость подключения номера (единоразовая!). Для обычных номеров она нулевая, а для красивых номеров будет определенная стоимость.
price_per_period — абонентская плата за период.
numbers — список свободных номеров.
Для покупки номера в группе методов «Управление услугами» выберите метод PUT «/account/{account_id}/billing/add-account-tariff» (Добавить услугу ЛС).

Для этого метода необходимо заполнить значения параметров:
- account_id — введите номер своего лицевого счета;
- service_type_id — ниже содержится описание, каким образом заполнить этот параметр;
- tariff_period_id — тарифный план для номера. Возможные значения
- voip_number — номер, который подключаем с интересующей нас степенью красивости (beauti_level).

Пример запроса (тело в JSON):

curl -X PUT "https://api.mcn.ru/v2/rest/account/123456789/billing/add-account-tariff" \
  -H "Authorization: Bearer your_api_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "service_type_id": 10,
    "tariff_period_id": 45,
    "voip_number": "+74951234567",
    "beauti_level": 1
  }'