Pasirinkite registracijos nutraukimo eigą
Nutraukite pranešimų siuntimo prekės ženklo registraciją, kai įmonei jos nebereikia. Taip nustojama naudoti esamą registraciją; nauja registracija nesukuriama, nuomojamų telefono numerių nuoma nenutraukiama, o įmonės tapatybės duomenys neištaisomi. Norėdami ištaisyti duomenis, naudokite Pranešimų siuntimo prekės ženklo atnaujinimas.
Viešasis prekės ženklo DELETE iškvietimas ir portalo veiksmas „Ištrinti prekės ženklą“ apima skirtingus veiksmus. Viešasis iškvietimas ištrina vieną registre esantį prekės ženklą. Prieš bandydamas ištrinti prekės ženklą, portalas koordinuoja numerių atsiejimą ir kampanijų išaktyvinimą.
| Veiksmų eiga | Atliekami veiksmai |
|---|---|
| Portalas: ištrinti prekės ženklą | Parodo susijusias kampanijas ir priskirtus numerius, reikalauja patvirtinti įvedant prekės ženklo identifikatorių, tada prieš ištrinant prekės ženklą bando sutvarkyti susijusius duomenis. Jei vėlesnis veiksmas nepavyksta, ankstesnių veiksmų rezultatai gali likti galioti. |
| API: DELETE /tcr/v2/brand/{brandId} | Pateikia užklausą ištrinti tik šį paskyrai priklausantį prekės ženklą. Numeriai automatiškai neatsiejami, o prekės ženklo kampanijos neišaktyvinamos. Aktyvi kampanija gali neleisti ištrinti prekės ženklo. |
Peržiūrėkite poveikį portale
Atverkite pranešimų siuntimo registracijos puslapį, raskite reikiamą prekės ženklą ir pasirinkite „Ištrinti prekės ženklą“. Peržiūrėkite susijusių kampanijų ir priskirtų numerių skaičių. Tiksliai įveskite prekės ženklo identifikatorių, kad galėtumėte atlikti galutinį veiksmą. Klientui skirta forma pasiekiama tik tada, kai paskyra turi leidimą tvarkyti registracijas.
Portalas aktyvias kampanijas apdoroja paeiliui: bando atsieti kiekvieną šiuo metu priskirtą numerį, išaktyvina kampaniją, o tada ištrina prekės ženklą. Kampanijų, kurios jau pažymėtos kaip nebegaliojančios arba ištrintos, pakartotinai ištrinti nuotolinėje sistemoje nebandoma. Sėkmingai atlikus šiuos veiksmus išorinėse sistemose, vietiniai kampanijų ir numerių įrašai atnaujinami vykdant duomenų bazės operaciją.
Ši veiksmų seka nėra viena atominė operacija, apimanti registrą, operatorių ir vietinius įrašus. Vėlesnė klaida negali atkurti numerio ar kampanijos, kurie jau buvo pakeisti išorinėje sistemoje. Išsaugokite grąžintą informaciją apie atsietus numerius ir išaktyvintas kampanijas, jei ji pateikiama; užuot kūrę kitą prekės ženklą, pagal šiuos identifikatorius patikrinkite ir suderinkite įrašus.
Pasiruoškite tiesioginiam ištrynimui per API
Naudokite įgalintą API paskyrą ir junkitės per HTTPS iš leidžiamo šaltinio IP adreso. Prekės ženklas turi priklausyti tai paskyrai. Nuskaitykite ir išsaugokite jo identifikatorių bei dabartinę būseną, tada patikrinkite jo kampanijas ir numerių priskyrimus. Atsiekite susijusius numerius ir išaktyvinkite kampanijas prieš ištrindami prekės ženklą. Nelaikykite šio DELETE iškvietimo pakopinio ištrynimo operacija.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Ištrinkite patikrintą prekės ženklą
Toliau pateiktą komandą vykdykite tik norėdami nutraukti numatytą registraciją, patikrinę prekės ženklo identifikatorių ir atlikę pirmiau nurodytus susijusių duomenų tvarkymo veiksmus. Užklausa neturi JSON turinio.
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"Dokumentacijoje nurodytas sėkmingas rezultatas yra HTTP 204 be atsakymo turinio. Nereikalaukite sėkmę nurodančio JSON objekto ar senosios v3 versijos status/response apvalkalo. Atmestas rezultatas su kodu, nepriklausančiu 2xx grupei, nepažymi prekės ženklo kaip ištrinto per dabartinį API sinchronizavimo mechanizmą.
Numatytai užklausai naudokite vieną idempotentiškumo raktą. Kartodami užklausą nekeiskite metodo, kelio, užklausos parametrų ir turinio baitų. Raktas nepaverčia visų portalo atliekamų susijusių duomenų tvarkymo veiksmų atomine operacija ir neįrodo, kad numeris buvo atsietas operatoriaus sistemoje. Dar vykdomos užklausos dublikatas gali grąžinti 409 su Retry-After; užbaigtoms užklausoms gali būti pakartotinai grąžintas išsaugotas atsakymas, įskaitant klaidą.
Patikrinkite registracijos nutraukimą ir suderinkite dalinius rezultatus
Po operacijos patikrinkite portalo prekės ženklų ir kampanijų sąrašus bei susijusius numerius. Viešosios API sėkmingo rezultato sinchronizavimas vietinėje sistemoje pažymi atskirą prekės ženklą kaip ištrintą; jis nepašalina kitų kampanijų išteklių ir nepanaikina įsigytų numerių priskyrimų. Būseną registre, priskyrimą operatoriaus sistemoje ir vietinį rodinį reikia tikrinti atskirai.
Dabartinis portalo operatoriaus adapteris priima sėkmingą HTTP atsakymą atskirai nepatikrinęs kiekvienos jo turinyje esančios veiklos būsenos reikšmės. Todėl po portale atliktų susijusių duomenų tvarkymo veiksmų patikrinkite, kokioms kampanijoms iš tikrųjų priskirti susiję numeriai, net jei portalas pranešė apie sėkmę. Jei priskyrimas ar būsena nesutampa, išsaugokite susijusius identifikatorius ir kreipkitės į pagalbos tarnybą prieš siųsdami pranešimus naudodami panaikintą konfigūraciją arba ją atkurdami.
Gavę HTTP 400, perskaitykite išsamią registro klaidą, ypač informaciją apie apribojimą dėl aktyvios kampanijos. Gavę 401, 403 arba 404, patikrinkite prisijungimo duomenis, leidžiamą šaltinio IP adresą ir priklausymą paskyrai. Gavę 429, laikykitės Retry-After nurodymo. Laukimo laikas gali baigtis arba kodas 500 ar 502 gali būti grąžintas jau atlikus pakeitimą išorinėje sistemoje; prieš kartodami užklausą patikrinkite esamą registraciją.
Patikrinkite likusius paskyros mokesčius
Dabartinė DELETE paslauga neinicijuoja iškart nurašomo prekės ženklo registracijos mokesčio. Ištrynus prekės ženklą, nuomojamų telefono numerių nuoma nenutraukiama, pinigai negrąžinami ir galutinis paskyros likutis nenustatomas. Portale peržiūrėkite visus esamus su kampanijomis susijusius įsipareigojimus, numerių nuomos ir naudojimo mokesčius. Ši operacija nėra šių atskirų paslaugų kainos pasiūlymas.