Намиране на налични мобилни номера

Потвърдете, че достъпът до налични мобилни номера е разрешен

Използвайте това търсене само след като за клиентския ви акаунт бъде разрешен достъпът до налични мобилни номера. Получете актуален индивидуален мобилен префикс чрез процедурата за откриване на достъпните префикси за акаунта. Поддържаният път заявява налични мобилни номера за този префикс. Той не зависи от съответстващ запис с метаданни за маршрутизиране в стационарната мрежа. Свържете се с поддръжката, ако не сте сигурни дали акаунтът или префиксът ви е активиран за тази услуга.

Съществуващият наследен маршрут не отхвърля надеждно всяка недопустима заявка. Акаунт без разрешен достъп до налични мобилни номера може да получи обикновени налични номера, въпреки че отговорът все пак съдържа info.is_mobile: 1. Префикс за безплатни повиквания също може да достигне до клона за налични безплатни номера с този етикет. Не използвайте само този етикет, за да определите дали услугата е мобилна, и не изпращайте обикновени префикси или префикси за безплатни повиквания към тази крайна точка. Използвайте потвърдения каталог с мобилни префикси за акаунта и разрешената процедура.

Запазвайте всеки номер заедно с неговия избор на цена

За всеки предложен номер запазвайте заедно number, info.uuid и списъка на същия запис price. Отговорът съдържа също метаданни за префикса, областта и държавата, договорни условия и ограничения за регистрация. Предложените номера са подредени във възходящ ред по месечната цена на първата си ценова опция; при еднакви цени не се гарантира постоянен ред. Не заменяйте върнатия идентификатор на номера с идентификатор на област или префикс и не го свързвайте с идентификатор на цена от друг предложен номер.

Пълният отговор може да включва допълнителни метаданни и ценови полета. Върнатите features, стойности за каналите и restrictions описват предложения номер; те не гарантират, че обажданията, SMS, MMS или факсът вече могат да се използват. Правата на акаунта, регистрацията и избраният тарифен план продължават да са определящи. Не приемайте заместващите стойности в примера за валидни идентификатори или цени.

Използвайте малко положително количество

Започнете с количество 1. Обичайната заявка към доставчика преобразува неположителното количество в 1 и ограничава изпращаната към него стойност до 300, но последващата обработка на резултатите продължава да използва първоначалната входна стойност. Затова нулево количество може да предизвика заявка за налични номера към доставчика, без да бъдат върнати предложени номера. Други наследени клонове не спазват последователно заявения брой резултати. Не разчитайте на единна универсална максимална стойност и не изпращайте отрицателни, дробни или нечислови стойности. За този маршрут не е документиран поддържан публичен филтър за търсене или параметър за идентификатор на цена в тялото на заявката.

Разграничавайте липсата на налични номера от неуспешната справка

Отговор 404 може да означава липса на налични номера, деактивирана услуга, неуспешна справка при доставчика или невалидни записи в каталога. При изтекло време за изчакване или грешка на доставчика приемайте наличността за неизвестна, а не за потвърдено нулева. Обновете избора и при необходимост опитайте отново с увеличаващи се интервали между опитите. Избягвайте многократното периодично запитване за всеки телефонен обменен префикс. Отделната крайна точка за броя налични мобилни номера дава моментна ориентировъчна стойност, която не е задължително да съвпада с дължината на списъка с предложени номера за този акаунт.

Проверете отново преди покупка

Търсенето не резервира налични номера. Прегледаният клон се опитва да изключи вече закупените номера, но неуспешна справка в локалните резервации може да остави такъв номер сред резултатите. Процедурата за покупка трябва да провери наличността, собствеността, одобрените цени и регистрацията. Използвайте нов избор със заявката за покупка с предпазни проверки и при неясен резултат от покупката сверете номерата в акаунта, преди да опитате отново. Никога не купувайте само защото даден номер е бил върнат като предложение.

Заявка

Използвайте активиран API акаунт през HTTPS от разрешен изходен IP адрес. За клиентския акаунт трябва също да е разрешен достъпът до налични мобилни номера; само удостоверяването чрез API не го разрешава.

Изпратете GET с актуалния идентификатор на индивидуалния префикс и положително цяло количество в URL пътя. Ако количеството е пропуснато, стойността по подразбиране е 1. Използвайте примера с 1; този маршрут не проверява и не налага последователно универсално ограничение на броя резултати.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

Параметри в пътя
Име	Тип	Задължителен	Описание
`prefix_id`	string	Да	Видимият идентификатор, чието съдържание не трябва да се интерпретира, на допустим индивидуален мобилен префикс, получен чрез откриването на достъпни префикси. Използвайте мобилен обменен префикс NPA/NXX, поддържан за акаунта ви; не го заменяйте с идентификатор на област, групиран идентификатор за показване, буквален префикс за набиране или префикс за безплатни повиквания.
`quantity`	integer	Не	Заявеният брой предложени номера. Стойността по подразбиране е 1. Подайте неголямо положително цяло число. Обичайната заявка към доставчика ограничава количеството си до 300, но това не означава универсална проверка на входната стойност или гаранция за размера на отговора.

Отговор

Проверявайте status.code и status.msg в JSON тялото, както и HTTP статуса. При успех response е списък с предложени номера, status.msg съдържа Results:, последвано от броя върнати номера, а status.results е дължината на сериализирания списък. Цените на предложените номера са специфични за акаунта. Съкратеният илюстративен пример използва заместващи стойности вместо реални налични номера или тарифна оферта. Номерата съдържат кода на държавата без знак плюс; идентификаторите са низове, чието съдържание не трябва да се интерпретира.

Илюстративна структура на отговора; не представлява текущи данни за акаунта или актуална оферта.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

Грешки

404: Невалиден идентификатор на префикс, държава или област: обновете избора на индивидуален мобилен префикс.
404: Не са намерени номера: може да означава липса на използваеми налични номера, деактивирана услуга, неуспешна справка при доставчика, неподдържан избор или ограничения на акаунта. Това не е достоверно доказателство, че броят на наличните номера е нула.

Наличност и странични ефекти

Търсенето не наема и не резервира номер, а прегледаният път не удържа сума за покупка. То се свързва с доставчика на налични номера и може да отнеме време.
Успешните търсения записват свързани с акаунта записи за номера и цени в кеша, както и дневници на заявките. Повторното търсене не представлява резервация, фиксиране на цена или покупка.
Върнатите цени, условия, ограничения и възможности трябва да бъдат прегледани за избрания акаунт и номер. Етикетът за дадена функция не удостоверява активиране, одобрение за изпращане на съобщения или проверена работоспособност на услугата.