Поднесите регистрациони профил за број

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

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

Користите омогућен MultiTEL API налог преко HTTPS-а, са подешеним приступним подацима и IP ограничењима. И необрисани профил и купљени број који није поништен морају припадати вашем налогу.

Направите регистрациони профил или изаберите постојећи. Сачувајте локални uuid профила добијен од create_document; get_document враћа исту локалну референцу као id.
За подношење преко оператера, профил мора да садржи сачуване референце на идентитет и адресу. Пре подношења приложите потребне доказе и пратеће документе кроз одговарајуће поступке.
Проверите да ли број и профил испуњавају важеће захтеве за земљу и број. Немојте претпостављати да је сачувани профил одобрен за сваки број.

Поднесите захтев за повезивање

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  --form-string document_uuid="$PROFILE_UUID" \
  --form-string service_description="Example customer support line" \
  https://api.multitel.net/v3/number_identity/12125550123

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

Поља за подношење регистрације
Поље	Обавезно	Значење
`document_uuid`	Да	Тачан сачувани локални uuid профила. Немојте уместо њега користити маскирани удаљени identity_id, address_id, идентификатор отпремања или враћену вредност registration_details_id.
`service_description`	Не	Опис предвиђене услуге, који се прослеђује на проверу преко оператера. Размаци на почетку и крају се уклањају.
`onetime_files`	Зависи од поступка	Низ који се прихвата за документе за једнократну употребу код оператера. Тренутни обрађивач уклања размаке на почетку и крају његових текстуалних вредности и прослеђује их без разрешавања локалних референци на отпремљене датотеке. Компатибилност са маскираним идентификаторима које враћа create_encrypt_files није утврђена; пре употребе овог поља погледајте ограничење за документе за једнократну употребу у наставку.

Код вишеделних захтева, низ се задаје понављањем поља onetime_files[]. Прихвата се и JSON захтев са Content-Type: application/json; његова својства се спајају са подацима обрасца. Поље number може да се наведе у телу захтева када је број изостављен из путање. Да бисте избегли двосмисленост, дајте предност изричитој путањи приказаној изнад.

Разликујте повезивање од одобрења

Прочитајте и HTTP резултат и JSON поље status.code. JSON грешке могу стићи уз HTTP 200. Успешно подношење преко оператера враћа поруку Address verification task created; awaiting carrier review. У овом примеру користе се измишљене референце.

{
  "status": {
    "code": 200,
    "msg": "Address verification task created; awaiting carrier review."
  },
  "response": {
    "number": "+12125550123",
    "did_id": "11111111111111111111111111111111",
    "document_uuid": "0123456789abcdef0123456789abcdef",
    "identity_id": "22222222222222222222222222222222",
    "address_id": "33333333333333333333333333333333",
    "address_verification_id": "44444444444444444444444444444444",
    "verification_status": "pending",
    "verification_reference": null,
    "requirement_id": "55555555555555555555555555555555",
    "registration_details_id": "8516ac99dc60603295de7bdb6a153530"
  }
}

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

Неки додељени бројеви користе локално повезивање идентитета уместо креирања провере код оператера. Њихов успешан резултат је Identity associated. са празним низом response. Тиме се не креира задатак за преглед код оператера нити се потврђује одобрење. Портал има новији поступак повезивања, чија се обрада добављача и провере поновног подношења разликују од ове крајње тачке.

Обрадите грешке без креирања дуплираних задатака

API код 400 означава да недостаје број или референца профила. Код 404 означава да профил или број нису доступни налогу или да број недостаје у инвентару оператера. Код 422 може да пријави недостајуће референце на идентитет или адресу, захтеве продавца или одбијање при валидацији код оператера. Недостајућа конфигурација повратног позива може да доведе до кода 503, а грешка у преносу при креирању до кода 502. Прочитајте поруку и све податке requirement_diagnostics, уместо да све неуспехе третирате на исти начин.

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

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

Ограничење за документе за једнократну употребу

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

Немојте претпостављати да се идентификатор датотеке из create_encrypt_files може копирати у ово поље како би се завршио поступак једнократног споразума. Када број захтева ове документе, користите портал или потврдите са MultiTEL-ом подржани поступак за идентификаторе. Ово остаје нерешен део прегледа API-ја, а не пример проверен од почетка до краја.

Заштитите податке о регистрацији

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