Zhvilluesit

DELETE/tcr/v2/brand/{brandId}

Hiqni nga përdorimi një markë mesazhesh

Zgjidhni mes pastrimit të bashkërenduar nga portali dhe fshirjes së drejtpërdrejtë të një marke, pastaj verifikoni fushatat dhe caktimet e numrave.

Në këtë faqe
  1. Zgjidhni rrjedhën e punës për heqjen nga përdorimi
  2. Shqyrtoni ndikimin në portal
  3. Përgatitni një fshirje të drejtpërdrejtë përmes API
  4. Fshini markën e shqyrtuar
  5. Verifikoni heqjen nga përdorimi dhe harmonizoni rezultatet e pjesshme
  6. Kontrolloni tarifat e mbetura të llogarisë

Zgjidhni rrjedhën e punës për heqjen nga përdorimi

Hiqni nga përdorimi një markë mesazhesh kur biznesi nuk ka më nevojë për atë regjistrim. Kjo ndërpret përdorimin e regjistrimit ekzistues; nuk regjistron një zëvendësues, nuk liron numrat e telefonit të marrë me qira dhe nuk korrigjon të dhënat e identitetit të biznesit. Për një korrigjim, përdorni Përditësoni një markë mesazhesh.

Thirrja publike DELETE për markën dhe veprimi Fshini markën në portal kanë shtrirje të ndryshme. Thirrja publike fshin një markë nga regjistri. Portali bashkërendon shkëputjen e numrave dhe çaktivizimin e fushatave përpara se të përpiqet të fshijë markën.

Mundësitë për heqjen e markës nga përdorimi
Rrjedha e punësÇfarë bën
Portali: Fshini markënShfaq fushatat e lidhura dhe numrat e caktuar, kërkon identifikuesin e markës si konfirmim dhe më pas përpiqet të kryejë pastrimin përkatës përpara se të fshijë markën. Hapat e mëparshëm mund të mbeten të përfunduar nëse një hap i mëvonshëm dështon.
API: DELETE /tcr/v2/brand/{brandId}Kërkon vetëm fshirjen e kësaj marke në pronësi të llogarisë. Nuk i shkëput automatikisht numrat dhe nuk i çaktivizon fushatat e markës. Një fushatë aktive mund ta pengojë fshirjen.

Shqyrtoni ndikimin në portal

Hapni faqen e regjistrimit për mesazhe, gjeni markën e duhur dhe zgjidhni Fshini markën. Shqyrtoni numrin e fushatave të lidhura dhe të numrave të caktuar. Shkruani identifikuesin e saktë të markës për të aktivizuar veprimin përfundimtar. Formulari për klientët është i disponueshëm vetëm kur llogaria ka leje për menaxhimin e regjistrimeve.

Portali i përpunon fushatat aktive me radhë: përpiqet të shkëputë çdo numër të caktuar aktualisht, çaktivizon fushatën dhe më pas fshin markën. Nuk kryen një fshirje tjetër në sistemin e largët për fushatat që janë shënuar tashmë si të skaduara ose të fshira. Pasi këta hapa të jashtëm përfundojnë me sukses, përditëson regjistrimet lokale të fushatave dhe numrave në një transaksion të bazës së të dhënave.

Kjo sekuencë nuk është një transaksion i vetëm atomik që përfshin regjistrin, operatorin dhe regjistrimet lokale. Një dështim i mëvonshëm nuk mund ta rikthejë një numër ose fushatë që është ndryshuar tashmë në sistemet e jashtme. Ruani hollësitë e kthyera për numrat e shkëputur dhe fushatat e çaktivizuara, kur janë të disponueshme; kontrolloni dhe harmonizoni gjendjen e elementeve me këta identifikues në vend që të krijoni një markë tjetër.

Përgatitni një fshirje të drejtpërdrejtë përmes API

Përdorni një llogari API të aktivizuar, përmes HTTPS, nga një adresë IP burimore e lejuar. Marka duhet t'i përkasë asaj llogarie. Lexoni dhe ruani identifikuesin dhe gjendjen e saj aktuale, pastaj kontrolloni fushatat dhe caktimet e numrave. Shkëputni numrat e prekur dhe çaktivizoni fushatat përpara se të fshini markën. Mos e trajtoni këtë DELETE si një veprim në kaskadë.

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

Fshini markën e shqyrtuar

Ekzekutoni komandën e mëposhtme vetëm për heqjen e synuar nga përdorimi, pasi të keni kontrolluar identifikuesin e markës dhe të keni përfunduar pastrimin e përshkruar më sipër. Kërkesa nuk ka trup 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"

Rezultati i suksesshëm i dokumentuar është HTTP 204, pa trup përgjigjeje. Mos kërkoni një objekt suksesi JSON ose mbështjellësin e vjetër v3 të tipit status/response. Një rezultat i refuzuar me kod jashtë klasës 2xx nuk e shënon markën si të fshirë përmes mekanizmit aktual të sinkronizimit API.

Përdorni një çelës të vetëm idempotence për kërkesën e synuar. Kur e ridërgoni, mbajini të pandryshuar bajtet e metodës, shtegut, vargut të parametrave të kërkimit dhe trupit. Çelësi nuk e bën atomik pastrimin e përgjithshëm në portal dhe nuk provon se një numër është shkëputur te operatori. Një kërkesë e dyfishtë ende në përpunim mund të kthejë 409 me Retry-After; për kërkesat e përfunduara mund të kthehet sërish përgjigjja e tyre e ruajtur, përfshirë një gabim.

Verifikoni heqjen nga përdorimi dhe harmonizoni rezultatet e pjesshme

Pas veprimit, kontrolloni listat e markave dhe fushatave në portal dhe numrat e prekur. Sinkronizimi pas suksesit i ndërfaqes publike API e shënon lokalisht markën përkatëse si të fshirë; nuk i heq burimet e tjera të fushatave dhe nuk i pastron caktimet e numrave të blerë. Statusi në regjistër, caktimi te operatori dhe shfaqja lokale kërkojnë kontrolle të veçanta.

Përshtatësi aktual i portalit për operatorin pranon një përgjigje suksesi HTTP pa verifikuar veçmas çdo vlerë të statusit të veprimit në trupin e saj. Për këtë arsye, pas një pastrimi në portal, verifikoni caktimet reale të numrave të prekur te fushatat, edhe nëse portali ka raportuar sukses. Nëse një caktim ose status nuk përputhet, ruani identifikuesit e prekur dhe kontaktoni mbështetjen përpara se të dërgoni mesazhe përmes konfigurimit të hequr nga përdorimi ose ta rikrijoni atë.

Për HTTP 400, lexoni gabimin e hollësishëm të regjistrit, sidomos nëse lidhet me një kufizim për shkak të një fushate aktive. Për 401, 403 ose 404, kontrolloni të dhënat e autentikimit, adresën IP burimore të lejuar dhe nëse marka është në pronësi të llogarisë. Për 429, respektoni Retry-After. Një skadim i kohës së pritjes, kodi 500 ose 502 mund të ndodhë pas një ndryshimi të jashtëm tashmë të përfunduar; shqyrtoni regjistrimin ekzistues përpara se ta përsëritni kërkesën.

Kontrolloni tarifat e mbetura të llogarisë

Shërbimi aktual DELETE nuk nis një debitim të menjëhershëm për regjistrimin e markës. Fshirja e një marke nuk liron numrat e telefonit të marrë me qira, nuk lëshon rimbursim dhe nuk përcakton bilancin përfundimtar të llogarisë. Shqyrtoni në portal çdo detyrim ekzistues për fushatat, si edhe tarifat e qirasë së numrave dhe të përdorimit. Ky veprim nuk përbën një ofertë çmimi për ato shërbime të veçanta.