CNAM интеграција

Референца CNAM REST API-ја

Затражите име позиваоца преко HTTPS-а и обрадите резултат, накнаду и грешке.

Изаберите понашање претраге

Ниво	Јавна цена по упиту	Шта ради
Starter	0,0026 US$	Користи сопствене и кеширане информације о имену позиваоца.
Standard	0,0037 US$	За сваки упит врши претрагу мреже у реалном времену.
Mixed	0,004 US$	Прво покушава претрагу у реалном времену, а затим се враћа на податке нивоа Starter када име није пронађено.

Изабрани сервис одређује понашање претраге; Mixed није претрага која прво користи кеш. Пре употребе у продукцији проверите цену додељену вашем налогу. Име позиваоца није доказ идентитета нити власништва.

Пошаљите аутентификовану претрагу

Крајња тачка: GET https://api.multitel.net/v3/cnam/NUMBER. Користите међународне цифре укључујући позивни број земље, без интерпункције и без водећег знака плус. Извршите ово са сервера ваше апликације користећи одобрене API креденцијале.

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multitel.net/v3/cnam/12025550123"

Обезбедите две променљиве окружења кроз конфигурацију тајни на страни сервера. Додељени bearer креденцијал је алтернатива само када је тај приступ омогућен и када су испуњена његова ограничења по изворној IP адреси. Никада не стављајте API тајну у јавни пакет кода за прегледач.

Водич за API аутентификацију и први захтев

Прочитајте JSON одговор

Овај одговор је илустративан. Враћено име и накнада зависе од претраге и изабраног сервиса.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE CALLER",
    "cost": "0.004",
    "balance": "24.9960"
  }
}

status.code: Апликативни код резултата; нормализујте вредности типа стринг и број пре поређења са 200.
status.msg: Пратећа порука о исходу или одбијању.
response.number: Број који је упитан.
response.name: Доступно име позиваоца.
response.cost: Накнада пријављена за овај упит; третирајте је као децимални износ.
response.balance: Пријављено стање налога, када је присутно.

Резултати без имена и грешке

Успешан захтев не гарантује користан назив позиваоца. Обрадите празно име, број враћен уместо имена и одбијену претрагу. Апликативни код 403 може означавати недовољно кредита, забрањену куповину или број без резултата; прегледајте поруку.

Пре приступа пољу response.name проверите и HTTP статус и JSON поље status. Објекат одговора може изостати у случају грешке. Недостајуће име не треба да спречи усмеравање уобичајеног позива.

Наплата, поновни покушаји и разлика у односу на ажурирање ID-ја позиваоца

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

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

Водич за CNAM интеграцију налога Затражите помоћ око интеграције