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

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

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

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

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

1. На главной странице Личного кабинета «Главное меню» в верхнем меню выберите пункт «API».

2. В левом меню выберите раздел «Методы API | Документация».

3. Раскройте группу методов «Работа с номерной емкостью» и вызовите метод «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
  }'

Была ли эта статья полезной

Да, полезнаНет, не полезна