Odaberite postupak povlačenja iz upotrebe
Povucite robnu marku za slanje poruka iz upotrebe kada poduzeću ta registracija više nije potrebna. Time se prestaje upotrebljavati postojeća registracija; ne registrira se zamjena, ne oslobađaju se unajmljeni telefonski brojevi niti se ispravljaju podaci o identitetu poduzeća. Za ispravak upotrijebite Ažurirajte robnu marku za slanje poruka.
Javni poziv DELETE za robnu marku i radnja Izbriši robnu marku na portalu imaju različit opseg. Javni poziv briše jednu robnu marku iz registra. Portal koordinira uklanjanje dodjela brojeva i deaktivaciju kampanja prije nego što pokuša izbrisati robnu marku.
| Postupak | Što radi |
|---|---|
| Portal: Izbriši robnu marku | Prikazuje povezane kampanje i dodijeljene brojeve, zahtijeva ID robne marke kao potvrdu, a zatim pokušava obaviti povezano čišćenje prije brisanja robne marke. Raniji koraci mogu ostati izvršeni ako kasniji korak ne uspije. |
| API: DELETE /tcr/v2/brand/{brandId} | Zahtijeva brisanje samo ove robne marke u vlasništvu računa. Ne uklanja automatski dodjele brojeva niti deaktivira kampanje robne marke. Aktivna kampanja može spriječiti brisanje. |
Pregledajte učinak na portalu
Otvorite stranicu za registraciju slanja poruka, pronađite odgovarajuću robnu marku i odaberite Izbriši robnu marku. Pregledajte broj povezanih kampanja i dodijeljenih brojeva. Unesite točan ID robne marke kako biste omogućili završnu radnju. Korisnički obrazac dostupan je samo ako račun ima dopuštenje za upravljanje registracijama.
Portal obrađuje aktivne kampanje redom: pokušava ukloniti dodjelu svakog trenutačno dodijeljenog broja, deaktivira kampanju, a zatim briše robnu marku. Preskače ponovno udaljeno brisanje kampanja koje su već označene kao istekle ili izbrisane. Nakon uspješnog dovršetka tih vanjskih koraka ažurira lokalne zapise kampanja i brojeva unutar transakcije baze podataka.
Taj slijed nije jedna atomska transakcija koja obuhvaća registar, operatora i lokalne zapise. Kasniji neuspjeh ne može vratiti broj ili kampanju koji su već promijenjeni u vanjskom sustavu. Sačuvajte vraćene podatke o brojevima čije su dodjele uklonjene i deaktiviranim kampanjama kada su dostupni; uskladite stanje za te identifikatore umjesto stvaranja nove robne marke.
Pripremite izravno brisanje putem sučelja API
Upotrijebite omogućen račun za API putem protokola HTTPS s dopuštene izvorišne IP adrese. Robna marka mora pripadati tom računu. Dohvatite i sačuvajte njezin ID i trenutačno stanje, a zatim provjerite njezine kampanje i dodjele brojeva. Uklonite dodjele zahvaćenih brojeva i deaktivirajte kampanje prije brisanja robne marke. Nemojte ovaj poziv DELETE smatrati kaskadnom operacijom.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Izbrišite pregledanu robnu marku
Sljedeće izvršite samo za namjeravano povlačenje iz upotrebe, nakon provjere ID-ja robne marke i dovršetka prethodnog čišćenja. Zahtjev nema tijelo u formatu 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"Dokumentirani uspješan rezultat je HTTP 204 bez tijela odgovora. Nemojte zahtijevati objekt uspjeha u formatu JSON ni naslijeđenu omotnicu v3 status/response. Odbijeni rezultat izvan raspona 2xx ne označava robnu marku kao izbrisanu putem trenutačnog mehanizma sinkronizacije sučelja API.
Upotrijebite jedan ključ idempotentnosti za namjeravani zahtjev. Pri ponavljanju zadržite metodu, putanju, upit i bajtove tijela nepromijenjenima. Ključ ne čini cjelokupno čišćenje na portalu atomskim i ne dokazuje da je dodjela broja uklonjena kod operatora. Duplikat zahtjeva koji se obrađuje može vratiti 409 sa zaglavljem Retry-After; dovršeni zahtjevi mogu ponovno vratiti svoj spremljeni odgovor, uključujući pogrešku.
Provjerite povlačenje iz upotrebe i uskladite djelomične rezultate
Nakon operacije provjerite popise robnih marki i kampanja na portalu te zahvaćene brojeve. Sinkronizacija nakon uspješnog poziva javnog sučelja API lokalno označava pojedinačnu robnu marku kao izbrisanu; ne uklanja ostale resurse kampanja niti briše dodjele kupljenih brojeva. Status u registru, dodjelu kod operatora i lokalni prikaz treba provjeriti zasebno.
Trenutačni adapter portala za operatora prihvaća uspješan odgovor HTTP bez zasebne provjere svake vrijednosti poslovnog statusa u njegovu tijelu. Zato nakon čišćenja putem portala provjerite stvarne dodjele zahvaćenih brojeva kampanjama, čak i ako je portal prijavio uspjeh. Ako dodjela ili status nisu usklađeni, sačuvajte zahvaćene ID-jeve i obratite se podršci prije slanja putem postave povučene iz upotrebe ili njezina ponovnog stvaranja.
Za HTTP 400 pročitajte detaljnu pogrešku registra, osobito ograničenje povezano s aktivnom kampanjom. Za 401, 403 ili 404 provjerite vjerodajnice, dopuštenu izvorišnu IP adresu i vlasništvo računa. Za 429 poštujte Retry-After. Istek vremena, 500 ili 502 mogu se pojaviti nakon dovršene vanjske promjene; pregledajte postojeću registraciju prije ponavljanja zahtjeva.
Provjerite preostale troškove računa
Trenutačna usluga DELETE ne pokreće trenutačno terećenje za registraciju robne marke. Brisanje robne marke ne oslobađa unajmljene telefonske brojeve, ne izdaje povrat novca niti utvrđuje konačno stanje računa. Na portalu pregledajte sve postojeće obveze za kampanje, najam brojeva i naknade za upotrebu. Ova operacija ne predstavlja ponudu cijene za te zasebne usluge.