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

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

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

• На главной странице Личного кабинета «Главное меню» в верхнем меню выберите пункт «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 = ‘Эксклюзивный’.
  Чем выше степень красивости, тем дороже стоит номер.

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

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

ВАЖНО! Теперь не нужно вызывать метод «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).