Пошаљите податке за упис телефонског броја у именик

Пошаљите податке за упис у именик оператера

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

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

Услови за налог и број

Користите омогућен API налог преко протокола HTTPS са дозвољене изворне IP адресе. Тачно тај број мора постојати као непоништен запис купљеног броја који припада том налогу. Користите све цифре међународног броја из своје евиденције, на пример формат са позивним бројем земље 1 за подржани северноамерички број. Не користите идентификатор тарифног плана, UUID броја нити број који припада другом налогу.

Захтев POST са подацима обрасца

Подесите NUMBER на број који поседујете. Замените измишљени пример одобреним подацима за упис у именик. Ова приступна путања чита поља обрасца из захтева POST; не рашчлањује тело у формату application/json.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

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

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

Наплата и поновни покушаји

Прегледана обрада захтева проверава да ли је на располагању најмање 10.00 јединица стања на налогу пре обраћања оператеру. Након што и оператер и локално ажурирање броја пријаве успех, одузима 10.00 са стања налога и бележи трансакцију за успостављање уписа у именик. Ово су износи који су тренутно уграђени у систем, а не нови предлог цена; пре слања проверите важећу валуту наплате и подржану услугу у условима свог налога.

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

Одговор

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

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

Грешке старије имплементације

Прочитајте и статус HTTP и поља у JSON status.code/status.msg. Провера идентитета и ограничења изворних IP адреса такође могу спречити добијање употребљивог одговора. Не користите GET нити параметре упита за захтевање ажурирања само зато што старија обрада захтева нема изричиту проверу методе HTTP.

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

1. Пре слања захтева потврдите број који поседујете, подршку оператера, одобрене податке за упис у именик и накнаду.
2. Пошаљите захтев једном и сачувајте резултат на страни налога, без откривања адресе корисника у јавним евиденцијама или аналитичким подацима.
3. Проверите сачувани упис и историју трансакција кроз подржани поступак у оквиру налога или преко подршке. Сачекајте време обраде које је оператер потврдио; овај API не дефинише гарантовани рок за ширење измене.
4. Када је резултат неизвесан, пре поновног покушаја затражите од подршке да усагласи налог код оператера и локалну наплату. Поновљени захтев није идемпотентна провера статуса.