Ontwikkelaars

DELETE/tcr/v2/brand/{brandId}

Stel 'n boodskapdienshandelsmerk buite gebruik

Kies tussen die portaal se gekoördineerde opruiming en die direkte uitvee van 'n handelsmerk, en verifieer daarna veldtogte en nommertoewysings.

Op hierdie bladsy
  1. Kies die werkvloei vir buitegebruikstelling
  2. Gaan die uitwerking in die portaal na
  3. Berei voor vir direkte uitvee via die API
  4. Vee die nagegane handelsmerk uit
  5. Verifieer die buitegebruikstelling en versoen gedeeltelike resultate
  6. Kontroleer die oorblywende rekeningheffings

Kies die werkvloei vir buitegebruikstelling

Stel 'n boodskapdienshandelsmerk buite gebruik wanneer die onderneming daardie registrasie nie meer nodig het nie. Dit beëindig die gebruik van die bestaande registrasie; dit registreer nie 'n plaasvervanger, stel nie gehuurde telefoonnommers vry en korrigeer nie die onderneming se identiteitsbesonderhede nie. Gebruik vir 'n regstelling Werk 'n boodskapdienshandelsmerk by.

Die openbare DELETE-oproep vir handelsmerke en die portaal se aksie Vee handelsmerk uit het verskillende omvang. Die openbare oproep vee een handelsmerk in die register uit. Die portaal koördineer die ontkoppeling van nommers en die deaktivering van veldtogte voordat dit die handelsmerk probeer uitvee.

Opsies vir die buitegebruikstelling van handelsmerke
WerkvloeiWat dit doen
Portaal: Vee handelsmerk uitToon gekoppelde veldtogte en toegewysde nommers, vereis die handelsmerk se ID as bevestiging en probeer dan die verwante opruiming uitvoer voordat die handelsmerk uitgevee word. Vroeëre stappe kan afgehandel bly as 'n latere stap misluk.
API: DELETE /tcr/v2/brand/{brandId}Versoek slegs die uitvee van hierdie handelsmerk wat aan die rekening behoort. Dit ontkoppel nie outomaties nommers of deaktiveer die handelsmerk se veldtogte nie. 'n Aktiewe veldtog kan uitvee verhinder.

Gaan die uitwerking in die portaal na

Maak die registrasiebladsy vir boodskapdienste oop, vind die regte handelsmerk en kies Vee handelsmerk uit. Gaan die getalle gekoppelde veldtogte en toegewysde nommers na. Tik die presiese handelsmerk-ID om die finale aksie te aktiveer. Die kliëntevorm is slegs beskikbaar wanneer die rekening toestemming het om registrasies te bestuur.

Die portaal verwerk aktiewe veldtogte opeenvolgend: dit probeer elke nommer wat tans toegewys is ontkoppel, deaktiveer die veldtog en vee dan die handelsmerk uit. Dit slaan 'n verdere uitvee in die afgeleë stelsel oor vir veldtogte wat reeds as verval of uitgevee gemerk is. Nadat daardie eksterne stappe slaag, werk dit die plaaslike veldtog- en nommerrekords in 'n databasistransaksie by.

Hierdie reeks stappe is nie een atomiese transaksie wat die register, diensverskaffer en plaaslike rekords dek nie. 'n Latere mislukking kan nie 'n nommer of veldtog herstel wat reeds ekstern verander is nie. Bewaar die teruggestuurde besonderhede van ontkoppelde nommers en gedeaktiveerde veldtogte wanneer dit beskikbaar is; versoen die toestand aan die hand van daardie identifiseerders eerder as om nog 'n handelsmerk te skep.

Berei voor vir direkte uitvee via die API

Gebruik 'n geaktiveerde API-rekening oor HTTPS vanaf 'n toegelate bron-IP-adres. Die handelsmerk moet aan daardie rekening behoort. Lees en bewaar die ID en huidige toestand daarvan, en kontroleer dan die veldtogte en nommertoewysings daarvan. Ontkoppel die betrokke nommers en deaktiveer veldtogte voordat jy die handelsmerk uitvee. Moenie hierdie DELETE as 'n kaskadebewerking beskou nie.

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

Vee die nagegane handelsmerk uit

Voer die volgende slegs vir die beoogde buitegebruikstelling uit, nadat jy die handelsmerk-ID nagegaan en die voorafgaande opruiming voltooi het. Daar is geen JSON-versoekliggaam nie.

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"

Die gedokumenteerde suksesvolle resultaat is HTTP 204 sonder 'n antwoordliggaam. Moenie 'n JSON-suksesobjek of die verouderde v3-status/response-omhulsel vereis nie. 'n Afgekeurde resultaat buite die 2xx-reeks merk nie die handelsmerk as uitgevee deur die huidige API-sinchronisasiepad nie.

Gebruik een idempotensiesleutel vir die beoogde versoek. Hou die metode, pad, navraag en liggaamsgrepe onveranderd wanneer jy dit weer stuur. Die sleutel maak nie die breër portaalopruiming atomies nie en bewys nie dat 'n diensverskaffernommer ontkoppel is nie. 'n Duplikaat waarvan die verwerking nog aan die gang is, kan 409 met Retry-After terugstuur; voltooide versoeke kan hul gestoorde antwoord weer terugstuur, insluitend 'n fout.

Verifieer die buitegebruikstelling en versoen gedeeltelike resultate

Kontroleer die portaal se handelsmerk- en veldtoglyste en die betrokke nommers ná die bewerking. Die openbare API se sinchronisasie ná sukses merk die individuele handelsmerk plaaslik as uitgevee; dit verwyder nie die ander veldtoghulpbronne of wis toewysings van gekoopte nommers uit nie. Registerstatus, toewysing by die diensverskaffer en die plaaslike vertoning moet afsonderlik nagegaan word.

Die portaal se huidige diensverskafferadapter aanvaar 'n HTTP-suksesantwoord sonder om elke besigheidstatuswaarde in die antwoordliggaam afsonderlik te valideer. Verifieer daarom die betrokke nommers se werklike veldtogtoewysings ná 'n portaalopruiming, selfs al het die portaal sukses gerapporteer. As 'n toewysing of status teenstrydig is, bewaar die betrokke ID's en kontak ondersteuning voordat jy deur die opstelling wat buite gebruik gestel is, stuur of dit herskep.

Lees by HTTP 400 die gedetailleerde registerfout, veral 'n beperking weens 'n aktiewe veldtog. Kontroleer by 401, 403 of 404 die aanmeldbesonderhede, toegelate bron-IP-adres en rekeningeienaarskap. Hou by 429 die wagtyd in Retry-After na. 'n Tydverstryking, 500 of 502 kan op 'n voltooide eksterne verandering volg; ondersoek die bestaande registrasie voordat jy die versoek herhaal.

Kontroleer die oorblywende rekeningheffings

Die huidige DELETE-diens stuur nie 'n onmiddellike debiet vir handelsmerkregistrasie uit nie. Die uitvee van 'n handelsmerk stel nie die gehuurde telefoonnommers vry, reik nie 'n terugbetaling uit en bepaal nie die finale rekeningsaldo nie. Gaan enige bestaande veldtogverpligtinge, nommerhuur en gebruiksheffings in die portaal na. Hierdie bewerking is nie 'n kwotasie vir daardie afsonderlike dienste nie.