Retrageți o marcă de mesagerie

Alegeți fluxul de retragere

Retrageți o marcă de mesagerie atunci când firma nu mai are nevoie de înregistrarea respectivă. Astfel încetează utilizarea înregistrării existente; nu se înregistrează un înlocuitor, nu se eliberează numerele de telefon închiriate și nu se corectează datele de identificare ale firmei. Pentru o corectare, folosiți Actualizați o marcă de mesagerie.

Apelul public DELETE pentru marcă și acțiunea Ștergeți marca din portal au sfere de acțiune diferite. Apelul public șterge o singură marcă din registru. Portalul coordonează dezasocierea numerelor și dezactivarea campaniilor înainte de a încerca ștergerea mărcii.

Examinați impactul în portal

Deschideți pagina de înregistrare pentru mesagerie, găsiți marca potrivită și alegeți Ștergeți marca. Verificați numărul campaniilor asociate și al numerelor alocate. Introduceți identificatorul exact al mărcii pentru a activa acțiunea finală. Formularul pentru clienți este disponibil numai când contul are permisiunea de gestionare a înregistrărilor.

Portalul procesează campaniile active pe rând: încearcă să dezasocieze fiecare număr alocat în prezent, dezactivează campania și apoi șterge marca. Omite o nouă ștergere la distanță pentru campaniile deja marcate ca expirate sau șterse. După ce acești pași externi reușesc, actualizează înregistrările locale ale campaniilor și numerelor într-o tranzacție a bazei de date.

Această succesiune nu constituie o singură tranzacție atomică pentru registru, operator și înregistrările locale. O eroare ulterioară nu poate restabili un număr sau o campanie deja modificată extern. Păstrați detaliile returnate despre numerele dezasociate și campaniile dezactivate, atunci când sunt disponibile; verificați și reconciliați starea elementelor cu acești identificatori în loc să creați o altă marcă.

Pregătiți o ștergere directă prin API

Folosiți un cont API activat, prin HTTPS, de la o adresă IP sursă permisă. Marca trebuie să aparțină acelui cont. Citiți și păstrați identificatorul și starea sa curentă, apoi verificați campaniile și alocările numerelor. Dezasociați numerele afectate și dezactivați campaniile înainte de a șterge marca. Nu tratați acest apel DELETE ca pe o operațiune în cascadă.

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

Ștergeți marca verificată

Executați comanda următoare numai pentru retragerea dorită, după ce ați verificat identificatorul mărcii și ați finalizat curățarea descrisă anterior. Cererea nu are un corp 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"

Rezultatul de succes documentat este HTTP 204, fără corp de răspuns. Nu impuneți existența unui obiect JSON de succes sau a vechiului înveliș v3 de tip status/response. Un rezultat respins, cu un cod din afara clasei 2xx, nu marchează marca drept ștearsă prin mecanismul curent de sincronizare API.

Folosiți o singură cheie de idempotență pentru cererea dorită. La retrimitere, păstrați neschimbați octeții metodei, ai căii, ai șirului de interogare și ai corpului. Cheia nu face atomică întreaga curățare din portal și nu dovedește că un număr a fost dezasociat la operator. O cerere duplicată aflată în curs poate returna 409 cu Retry-After; pentru cererile finalizate se poate returna din nou răspunsul salvat, inclusiv o eroare.

Verificați retragerea și reconciliați rezultatele parțiale

Verificați listele de mărci și campanii din portal și numerele afectate după operațiune. Sincronizarea în caz de succes a interfeței publice API marchează local marca respectivă drept ștearsă; nu elimină celelalte resurse de campanie și nu șterge alocările numerelor achiziționate. Starea din registru, alocarea la operator și afișarea locală necesită verificări separate.

Adaptorul curent al portalului pentru operator acceptă un răspuns HTTP de succes fără a valida separat fiecare valoare a stării operațiunii din corpul acestuia. Din acest motiv, verificați alocările efective la campanii ale numerelor afectate după o curățare în portal, chiar dacă portalul a raportat succes. Dacă o alocare sau o stare este neconcordantă, păstrați identificatorii afectați și contactați serviciul de asistență înainte de a trimite mesaje prin configurația retrasă sau de a o recrea.

Pentru HTTP 400, citiți eroarea detaliată a registrului, în special o eventuală restricție legată de o campanie activă. Pentru 401, 403 sau 404, verificați datele de autentificare, adresa IP sursă permisă și apartenența mărcii la cont. Pentru 429, respectați Retry-After. O expirare a timpului de așteptare, un cod 500 sau 502 poate surveni după o modificare externă deja finalizată; examinați înregistrarea existentă înainte de a repeta cererea.

Verificați taxele rămase ale contului

Serviciul DELETE curent nu declanșează o debitare imediată pentru înregistrarea mărcii. Ștergerea unei mărci nu eliberează numerele de telefon închiriate, nu emite o rambursare și nu stabilește soldul final al contului. Examinați în portal orice angajamente existente pentru campanii, precum și taxele de închiriere a numerelor și de utilizare. Această operațiune nu constituie o ofertă de preț pentru serviciile respective, care sunt separate.