Пронађите доступне мобилне бројеве

Потврдите да је мобилни инвентар омогућен

Користите ову претрагу само након што је инвентар мобилних бројева омогућен за ваш кориснички налог. Набавите текући појединачни мобилни префикс кроз ток откривања налога. Подржани пут захтева бежични инвентар за тај префикс. Не зависи од одговарајућег записа метаподатака рутирања фиксне линије. Контактирајте подршку ако нисте сигурни да ли су ваш налог или префикс омогућени.

Тренутна наслеђена рута не одбија поуздано сваки неподобни захтев. Налог без омогућеног мобилног инвентара може примити обичан инвентар док одговор и даље каже info.is_mobile: 1. Префикс без наплате такође може доспети у грану инвентара без наплате са том ознаком. Не користите само ту ознаку за идентификовање мобилног сервиса и не шаљите обичне или бесплатне префиксе на ову крајњу тачку. Користите потврђени мобилни каталог налога и омогућени ток рада.

Држите сваки број уз његов избор цене

За сваког кандидата, држите number, info.uuid и листу те исте ставке price заједно. Одговор такође садржи метаподатке префикса/области/земље, уговорне услове и ограничења регистрације. Кандидати су сортирани по месечној цени прве опције цене, растуће; није гарантован стабилан редослед за једнаке цене. Не замените враћени ID броја ID-ом области или префикса, нити га упарите са ID-ом цене другог кандидата.

Комплетан одговор може садржати додатна поља метаподатака и цена. Враћени features, вредности канала и restrictions описују кандидата; они нису гаранција да су позиви, SMS, MMS или факс већ употребљиви. Дозволе налога, регистрација и изабрани план сервиса и даље се примењују. Не третирајте чуваре места из примера као важеће ID-ове или цене.

Користите малу позитивну количину

Почните са количином од 1. Нормалан захтев добављача нормализује непозитивну количину на 1 и ограничава узводну вредност на 300, али каснија обрада резултата и даље користи оригинални унос. Количина нула зато може захтевати узводни инвентар и не вратити ниједног кандидата. Друге наслеђене гране не примењују доследно тражени број резултата. Не ослањајте се на један универзални максимум и не шаљите негативне, разломачке или небројчане вредности. Ниједан подржани јавни филтер претраге нити параметар тела са ID-ом цене није документован за ову руту.

Разликујте недостатак залиха од неуспеха претраге

Одговор 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"

Одговор

Проверите 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: Неисправан ID префикса, земље или области: освежите избор појединачног мобилног префикса.
• 404: Бројеви нису пронађени: може значити неупотребљиве залихе, онемогућен сервис, неуспешну претрагу добављача, неподржан избор или ограничења налога. Није доказ ауторитативног нултог броја инвентара.

Доступност и споредни ефекти

• Претрага не изнајмљује и не резервише број, а прегледани пут не терети налог износом куповине. Контактира добављача инвентара и може потрајати.
• Успешне претраге записују уносе кеша бројева и цена везане за налог и дневнике упита. Понављање претраге није резервација, закључавање цене нити куповина.
• Враћене цене, услови, ограничења и могућности морају се прегледати за изабрани налог и број. Ознака функције не успоставља активацију, одобрење размене порука нити тестирану функционалност сервиса.