Изаберите поступак повлачења из употребе
Повуците бренд за размену порука из употребе када предузећу та регистрација више није потребна. Тиме се прекида коришћење постојеће регистрације; не региструје се замена, не ослобађају се изнајмљени телефонски бројеви и не исправљају се идентификациони подаци предузећа. За исправку користите Ажурирање бренда за размену порука.
Јавни позив DELETE за бренд и радња „Обриши бренд“ на порталу имају различит обухват. Јавни позив брише један бренд из регистра. Портал координише уклањање додела бројева и деактивацију кампања пре него што покуша да обрише бренд.
| Поступак | Шта обавља |
|---|---|
| Портал: Обриши бренд | Приказује повезане кампање и додељене бројеве, захтева идентификатор бренда као потврду, а затим покушава да уклони повезане доделе и деактивира кампање пре брисања бренда. Ранији кораци могу остати извршени ако неки каснији корак не успе. |
| API: DELETE /tcr/v2/brand/{brandId} | Захтева брисање само овог бренда у власништву налога. Не уклања аутоматски доделе бројева нити деактивира кампање бренда. Активна кампања може спречити брисање. |
Прегледајте последице на порталу
Отворите страницу за регистрацију размене порука, пронађите одговарајући бренд и изаберите „Обриши бренд“. Прегледајте број повезаних кампања и додељених бројева. Унесите тачан идентификатор бренда да бисте омогућили завршну радњу. Кориснички образац је доступан само када налог има дозволу за управљање регистрацијама.
Портал обрађује активне кампање редом: покушава да уклони доделу сваког тренутно додељеног броја, деактивира кампању, а затим брише бренд. За кампање које су већ означене као истекле или обрисане прескаче поновно брисање у удаљеном систему. Када ти спољни кораци успеју, ажурира локалне записе о кампањама и бројевима у оквиру трансакције базе података.
Овај низ корака није једна атомска трансакција која обухвата регистар, оператера и локалне записе. Каснији неуспех не може вратити претходно стање броја или кампање који су већ измењени у спољном систему. Сачувајте враћене податке о бројевима чије су доделе уклоњене и деактивираним кампањама када су доступни; проверите и усагласите стање за те идентификаторе уместо да правите други бренд.
Припремите директно брисање преко API
Користите омогућен API налог преко HTTPS са дозвољене изворне IP адресе. Бренд мора припадати том налогу. Прочитајте и сачувајте његов идентификатор и тренутно стање, а затим проверите његове кампање и доделе бројева. Уклоните доделе обухваћених бројева и деактивирајте кампање пре брисања бренда. Не сматрајте овај позив DELETE каскадном операцијом.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Обришите проверени бренд
Извршите следеће само за намеравано повлачење из употребе, након што проверите идентификатор бренда и довршите претходно уклањање додела и деактивацију кампања. Захтев нема тело у формату JSON.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request DELETE \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Документовани успешан резултат је HTTP 204 без тела одговора. Не захтевајте JSON објекат који потврђује успех нити застарелу v3 структуру одговора status/response. Одбијени резултат са статусом ван опсега 2xx не означава бренд као обрисан путем тренутног механизма синхронизације API.
Користите један кључ идемпотентности за намеравани захтев. При поновном слању немојте мењати метод, путању, упит ни бајтове тела. Кључ не чини шири поступак уклањања повезаних података на порталу атомским и не доказује да је додела броја код оператера уклоњена. Дупликат захтева чија је обрада у току може вратити 409 са Retry-After; за довршене захтеве може се поново вратити њихов сачувани одговор, укључујући грешку.
Проверите повлачење из употребе и усагласите делимичне резултате
Након операције проверите листе брендова и кампања на порталу, као и обухваћене бројеве. Синхронизација након успешног позива јавног API означава појединачни бренд као обрисан локално; не уклања остале ресурсе кампања нити брише доделе купљених бројева. Статус у регистру, додела код оператера и локални приказ проверавају се засебно.
Тренутни адаптер портала за оператера прихвата успешан HTTP одговор без засебне провере сваке вредности пословног статуса у његовом телу. Зато после уклањања повезаних података преко портала проверите стварне доделе обухваћених бројева кампањама, чак и ако је портал пријавио успех. Ако додела или статус нису усаглашени, сачувајте обухваћене идентификаторе и обратите се подршци пре слања порука путем повучене конфигурације или њеног поновног прављења.
За HTTP 400 прочитајте детаљну грешку регистра, посебно ограничење због активне кампање. За 401, 403 или 404 проверите приступне податке, дозвољену изворну IP адресу и власништво налога над брендом. За 429 поштујте Retry-After. Истек времена чекања, 500 или 502 могу уследити након довршене промене у спољном систему; прегледајте постојећу регистрацију пре него што поновите захтев.
Проверите преостала задужења налога
Тренутна услуга DELETE не покреће тренутно задужење за регистрацију бренда. Брисање бренда не ослобађа изнајмљене телефонске бројеве, не доводи до повраћаја новца и не утврђује коначно стање на налогу. На порталу прегледајте све постојеће обавезе у вези са кампањама, закупом бројева и трошковима коришћења. Ова операција не представља понуду цене за те засебне услуге.