Пронађите име позиваоца

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

Враћено име не представља потврду идентитета, власништва нити дозволу за позивање. Имена могу недостајати, бити застарела или скраћена, а уместо њих могу бити наведене географске ознаке или сам телефонски број као заменска вредност.

Захтев

Користите свој активирани API налог са изворне IP адресе која је за њега дозвољена. Чувајте приступне податке у складишту тајни на серверу. Пример користи променљиве окружења и измишљени северноамерички број; немојте стављати приступне податке у URL адресе нити у јавно доступан код који се извршава у прегледачу.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cnam/12025550123

Наведите цео број цифрама, укључујући позивни број земље, на пример једанаест цифара које почињу цифром 1 за Северну Америку. Не ослањајте се на то да ће обрађивач нормализовати интерпункцију или знак плус. Нису потребни тело захтева нити избор региона. Проверите са компанијом MultiTEL која је покривеност подржана за вашу планирану употребу.

Одговор

Вредности су дате само као илустрација; наведени трошак није понуда цене.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

Поља упита за име позиваоца
Поље	Значење
number	Број наведен у захтеву.
name	Доступно име или заменски текст. То није потврда идентитета.
cost	Подешена цена упита за налог или услугу коју ова путања обраде пријављује. Користите важећу тарифу налога, а не илустративну вредност.
balance	Стање израчунато за одговор. То није нови трансакциони упит за стање налога.

Наплата и усаглашавање евиденције

Резултати који садрже име наплаћују се по цени за CNAM подешеној за налог. Поновљени упит или упит чији резултат долази из кеша може довести до нове наплате; кључ идемпотентности није доступан. Проверите важећу тарифу налога пре него што омогућите аутоматизоване упите.

Постоји познато ограничење одговора када је кеширано име празно: обрађивач може да врати API код 200 са празним именом, трошком различитим од нуле и умањеним израчунатим стањем, иако та грана обраде не задужује налог. Не сматрајте сам тај одговор доказом наплате. Усагласите податке са евиденцијом наплате налога и резултатом који даје нова провера стања, а за нејасне резултате обратите се подршци.

Провера припејд средстава тренутно захтева стање од најмање 0.004 пре упита, независно од подешене цене по упиту. Одбија се и налог на ком су куповине онемогућене. Ове провере не чине ову крајњу тачку API интерфејсом за понуде цена или ограничавање потрошње.

Грешке и поновни покушаји

Проверите и HTTP статус и JSON поља status.code/status.msg. API код 403 може да означава недовољно припејд средстава, забрањене куповине, проблем са овлашћењима налога или да име позиваоца није пронађено. Путања обраде без пронађеног имена може да врати код као текстуални низ. Прочитајте поруку уместо да сваки код 403 тумачите као неисправне приступне податке. Сукоби у конфигурацији могу да врате API код 500.

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

Друге операције са бројевима

Ова операција читања одвојена је од ажурирања имена за одлазне позиве/података у LIDB, уписа у именик или регистрације позиваоца. За те операције важе засебна обавезна поља, овлашћења и накнаде. Користите покривеност доделом бројева за проверу табеле префикса или претрагу бројева за бројеве који су доступни за наручивање. Ниједна од ових операција не потврђује да је позивалац онај за кога се представља.