Sõnumsidebrändi kasutusest kõrvaldamine

Valige kasutusest kõrvaldamise töövoog

Kõrvaldage sõnumsidebränd kasutusest, kui ettevõte seda registreeringut enam ei vaja. See lõpetab olemasoleva registreeringu kasutamise; see ei registreeri asendajat, ei vabasta renditud telefoninumbreid ega paranda ettevõtte identiteediandmeid. Paranduste tegemiseks kasutage juhendit Sõnumsidebrändi uuendamine.

Avaliku brändi DELETE kutse ja portaali toimingu Kustuta bränd ulatus on erinev. Avalik kutse kustutab registrist ühe brändi. Portaal koordineerib numbrite lahtisidumist ja kampaaniate deaktiveerimist, enne kui proovib brändi kustutada.

Vaadake mõju portaalis üle

Avage sõnumside registreerimise leht, leidke õige bränd ja valige Kustuta bränd. Vaadake üle seotud kampaaniate ja määratud numbrite arv. Sisestage täpne brändi ID, et lõplik toiming muutuks kasutatavaks. Kliendivorm on saadaval ainult siis, kui kontol on registreeringute haldamise õigus.

Portaal töötleb aktiivseid kampaaniaid järjest: proovib iga praegu määratud numbri lahti siduda, deaktiveerib kampaania ja kustutab seejärel brändi. Juba aegunuks või kustutatuks märgitud kampaaniate puhul jätab see korduva kustutamise kaugsüsteemis vahele. Kui need välised sammud õnnestuvad, uuendab portaal kohalikke kampaania- ja numbrikirjeid andmebaasitehingus.

See toimingute jada ei ole üks atomaarne tehing, mis hõlmaks registrit, sideoperaatorit ja kohalikke kirjeid. Hilisem tõrge ei saa taastada numbrit ega kampaaniat, mida on välises süsteemis juba muudetud. Säilitage tagastatud andmed lahtiseotud numbrite ja deaktiveeritud kampaaniate kohta, kui need on saadaval; viige kirjed nende identifikaatorite alusel kooskõlla, selle asemel et luua uus bränd.

Valmistage ette otsene kustutamine API kaudu

Kasutage lubatud lähte-IP-aadressilt aktiveeritud API kontot HTTPS ühenduse kaudu. Bränd peab kuuluma sellele kontole. Lugege ja säilitage selle ID ning praegune olek, seejärel kontrollige selle kampaaniaid ja numbrite seoseid. Siduge mõjutatud numbrid lahti ja deaktiveerige kampaaniad enne brändi kustutamist. Ärge käsitage seda DELETE kutset kaskaadtoiminguna.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Kustutage ülevaadatud bränd

Käivitage järgmine käsk ainult kavandatud kasutusest kõrvaldamiseks pärast brändi ID kontrollimist ja eelnevate korrastustoimingute lõpetamist. Päringul puudub JSON sisuosa.

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"

Dokumenteeritud edukas tulemus on HTTP 204 ilma vastuse sisuosata. Ärge nõudke JSON eduobjekti ega pärandversiooni v3 status/response ümbrist. Tagasilükatud tulemus koodiga väljaspool 2xx vahemikku ei märgi brändi praeguse API sünkroonimisprotsessi kaudu kustutatuks.

Kasutage kavandatud päringu jaoks ühte idempotentsusvõtit. Kordamisel jätke meetod, tee, päringuparameetrid ja sisuosa baidid muutmata. Võti ei muuda portaali ulatuslikumaid korrastustoiminguid atomaarseks ega tõenda, et sideoperaatori number on lahti seotud. Veel töös oleva päringu duplikaat võib tagastada 409 koos päisega Retry-After; lõpetatud päringute puhul võidakse uuesti esitada nende salvestatud vastus, sealhulgas veavastus.

Kontrollige kasutusest kõrvaldamist ja viige osalised tulemused kooskõlla

Kontrollige pärast toimingut portaali brändide ja kampaaniate loendeid ning mõjutatud numbreid. Avaliku API eduka tulemuse sünkroonimine märgib konkreetse brändi kohalikult kustutatuks; see ei eemalda teisi kampaaniaressursse ega tühjenda ostetud numbrite seoseid. Registri olekut, sideoperaatori juures määratud seost ja kohalikku kuva tuleb kontrollida eraldi.

Portaali praegune sideoperaatori adapter võtab vastu HTTP eduvastuse, kontrollimata eraldi iga selle sisuosas olevat äriloogika olekuväärtust. Seetõttu kontrollige pärast portaali korrastustoiminguid mõjutatud numbrite tegelikke kampaaniaseoseid ka siis, kui portaal teatas õnnestumisest. Kui seos või olek on vastuoluline, säilitage mõjutatud ID-d ja võtke ühendust klienditoega, enne kui saadate sõnumeid kasutusest kõrvaldatud seadistuse kaudu või loote selle seadistuse uuesti.

Vastuse HTTP 400 korral lugege registri üksikasjalikku veateadet, pöörates erilist tähelepanu aktiivse kampaania piirangule. Vastuste 401, 403 või 404 korral kontrollige autentimisandmeid, lubatud lähte-IP-aadressi ja kontole kuuluvust. Vastuse 429 korral järgige päist Retry-After. Ajalõpp, 500 või 502 võib ilmneda pärast välise muudatuse lõpuleviimist; kontrollige enne päringu kordamist olemasolevat registreeringut.

Kontrollige kontole alles jäävaid tasusid

Praegune DELETE teenus ei algata kohest brändi registreerimistasu debiteerimist. Brändi kustutamine ei vabasta renditud telefoninumbreid, ei algata tagasimakset ega määra konto lõplikku saldot. Vaadake portaalis üle olemasolevad kampaaniakohustused ning numbrite rendi- ja kasutustasud. See toiming ei ole nende eraldi teenuste hinnapakkumine.