Ziņojumapmaiņas zīmola izmantošanas pārtraukšana

Izvēlieties izmantošanas pārtraukšanas darbplūsmu

Pārtrauciet ziņojumapmaiņas zīmola izmantošanu, kad uzņēmumam attiecīgā reģistrācija vairs nav vajadzīga. Tādējādi tiek pārtraukta esošās reģistrācijas izmantošana; netiek reģistrēts aizstājējs, atbrīvoti nomātie tālruņa numuri vai laboti uzņēmuma identitātes dati. Lai veiktu labojumus, izmantojiet sadaļu Ziņojumapmaiņas zīmola atjaunināšana.

Publiskajam zīmola DELETE izsaukumam un portāla darbībai Dzēst zīmolu ir atšķirīgs tvērums. Publiskais izsaukums dzēš vienu zīmolu reģistrā. Portāls koordinē numuru atsaistīšanu un kampaņu deaktivizēšanu, pirms mēģina dzēst zīmolu.

Izvērtējiet ietekmi portālā

Atveriet ziņojumapmaiņas reģistrācijas lapu, atrodiet pareizo zīmolu un izvēlieties Dzēst zīmolu. Pārskatiet saistīto kampaņu un piesaistīto numuru skaitu. Ievadiet precīzu zīmola ID, lai iespējotu galīgo darbību. Klienta veidlapa ir pieejama tikai tad, ja kontam ir reģistrāciju pārvaldības atļauja.

Portāls apstrādā aktīvās kampaņas secīgi: tas mēģina atsaistīt katru pašlaik piesaistīto numuru, deaktivizē kampaņu un pēc tam dzēš zīmolu. Kampaņām, kas jau atzīmētas kā tādas, kuru termiņš ir beidzies, vai kā dzēstas, atkārtota attālināta dzēšana tiek izlaista. Kad šīs ārējās darbības ir sekmīgi pabeigtas, portāls datubāzes transakcijā atjaunina vietējos kampaņu un numuru ierakstus.

Šī darbību secība nav viena atomāra transakcija, kas aptvertu reģistru, operatoru un vietējos ierakstus. Vēlāka kļūme nevar atjaunot numuru vai kampaņu, kas ārējā sistēmā jau ir mainīta. Saglabājiet atbildē saņemto informāciju par atsaistītajiem numuriem un deaktivizētajām kampaņām, ja tā ir pieejama; saskaņojiet ierakstus pēc šiem identifikatoriem, nevis veidojiet vēl vienu zīmolu.

Sagatavojieties tiešai dzēšanai ar API

Izmantojiet iespējotu API kontu, izveidojot savienojumu ar HTTPS no atļautas avota IP adreses. Zīmolam ir jāpieder šim kontam. Nolasiet un saglabājiet tā ID un pašreizējo stāvokli, pēc tam pārbaudiet tā kampaņas un numuru piesaistes. Atsaistiet ietekmētos numurus un deaktivizējiet kampaņas pirms zīmola dzēšanas. Neuzskatiet šo DELETE par kaskādes darbību.

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

Dzēsiet pārbaudīto zīmolu

Izpildiet tālāk norādīto tikai paredzētajai izmantošanas pārtraukšanai pēc zīmola ID pārbaudes un iepriekš aprakstītās saistīto resursu sakārtošanas. Pieprasījumam nav JSON pamatdaļas.

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"

Dokumentētais sekmīgas izpildes rezultāts ir HTTP 204 bez atbildes pamatdaļas. Nepieprasiet JSON sekmīgas izpildes objektu vai mantoto v3 status/response ietvaru. Noraidīts rezultāts ar kodu ārpus 2xx diapazona pašreizējā API sinhronizācijas procesā neatzīmē zīmolu kā dzēstu.

Paredzētajam pieprasījumam izmantojiet vienu idempotences atslēgu. Atkārtojot pieprasījumu, nemainiet metodi, ceļu, vaicājumu vai pamatdaļas baitus. Atslēga nepadara plašāko portāla resursu sakārtošanas procesu atomāru un nepierāda, ka operatora numurs ir atsaistīts. Pieprasījuma, kas vēl tiek apstrādāts, dublikāts var atgriezt 409 ar Retry-After; pabeigtiem pieprasījumiem var atkārtoti atgriezt saglabāto atbildi, arī kļūdu.

Pārbaudiet izmantošanas pārtraukšanu un saskaņojiet daļējos rezultātus

Pēc darbības pārbaudiet portāla zīmolu un kampaņu sarakstus un ietekmētos numurus. Publiskā API sekmīgas izpildes sinhronizācija vietēji atzīmē konkrēto zīmolu kā dzēstu; tā nedzēš citus kampaņu resursus un nenoņem iegādāto numuru piesaistes. Reģistra statuss, piesaiste pie operatora un vietējais attēlojums jāpārbauda atsevišķi.

Pašreizējais portāla operatora adapteris pieņem HTTP sekmīgas izpildes atbildi, atsevišķi nepārbaudot katru darbības statusa vērtību tās pamatdaļā. Tādēļ pēc resursu sakārtošanas portālā pārbaudiet ietekmēto numuru faktiskās piesaistes kampaņām arī tad, ja portāls ziņoja par sekmīgu izpildi. Ja piesaiste vai statuss ir pretrunīgs, saglabājiet ietekmētos ID un sazinieties ar atbalsta dienestu, pirms sūtāt ziņojumus, izmantojot iepriekšējo konfigurāciju, vai izveidojat šo konfigurāciju no jauna.

Saņemot HTTP 400, izlasiet detalizēto reģistra kļūdas ziņojumu, īpaši pievēršot uzmanību aktīvas kampaņas ierobežojumam. Saņemot 401, 403 vai 404, pārbaudiet akreditācijas datus, atļauto avota IP adresi un piederību kontam. Saņemot 429, ievērojiet Retry-After. Noildze, 500 vai 502 var rasties pēc tam, kad ārējās izmaiņas jau ir pabeigtas; pirms pieprasījuma atkārtošanas pārbaudiet esošo reģistrāciju.

Pārbaudiet atlikušās konta maksas

Pašreizējais DELETE pakalpojums neierosina tūlītēju maksas norakstīšanu par zīmola reģistrāciju. Zīmola dzēšana neatbrīvo nomātos tālruņa numurus, neizraisa naudas atmaksu un nenosaka galīgo konta atlikumu. Portālā pārskatiet esošās kampaņu saistības, numuru nomas un lietošanas maksas. Šī darbība nav cenas piedāvājums par šiem atsevišķajiem pakalpojumiem.