Проверете името на обаждащия се

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

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

Заявка

Използвайте активирания си 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, вписването в телефонен указател или регистрацията на обаждащ се. Тези операции имат собствени задължителни полета, права за достъп и такси. Използвайте покритието на разпределените номера за проверка в таблицата с префикси или търсенето на номера за номера, налични за поръчка. Нито една от тези операции не удостоверява, че обаждащият се е този, за когото се представя.