Üzenetküldési márka kivezetése

Válassza ki a kivezetés folyamatát

Vezesse ki az üzenetküldési márkát, ha a vállalkozásnak már nincs szüksége az adott regisztrációra. Ezzel megszűnik a meglévő regisztráció használata; a művelet nem regisztrál helyette újat, nem szabadítja fel a bérelt telefonszámokat, és nem javítja a vállalkozás azonosító adatait. Javításhoz használja a következő lehetőséget: Üzenetküldési márka frissítése.

A nyilvános, márkára vonatkozó DELETE hívás és a portál Márka törlése műveletének hatóköre eltér. A nyilvános hívás egyetlen márkát töröl a nyilvántartásból. A portál összehangolja a számok leválasztását és a kampányok inaktiválását, mielőtt megkísérli a márka törlését.

Tekintse át a hatásokat a portálon

Nyissa meg az üzenetküldési regisztráció oldalát, keresse meg a megfelelő márkát, és válassza a Márka törlése lehetőséget. Tekintse át a kapcsolódó kampányok és a hozzárendelt számok darabszámát. A végső művelet engedélyezéséhez írja be pontosan a márka azonosítóját. Az ügyfeleknek szánt űrlap csak akkor érhető el, ha a fiók rendelkezik regisztrációkezelési jogosultsággal.

A portál sorban dolgozza fel az aktív kampányokat: megkísérli leválasztani az összes jelenleg hozzárendelt számot, inaktiválja a kampányt, majd törli a márkát. A már lejártként vagy töröltként megjelölt kampányoknál kihagyja az újabb távoli törlést. A külső lépések sikeres befejezése után egy adatbázis-tranzakcióban frissíti a helyi kampány- és számrekordokat.

Ez a lépéssor nem alkot egyetlen atomi tranzakciót a nyilvántartás, a távközlési szolgáltató és a helyi rekordok között. Egy későbbi hiba nem tudja visszaállítani a külső rendszerben már módosított számot vagy kampányt. Ha rendelkezésre állnak, őrizze meg a válaszban kapott adatokat a leválasztott számokról és az inaktivált kampányokról; újabb márka létrehozása helyett ezeknek az azonosítóknak az állapotát egyeztesse.

Készítse elő a közvetlen API-törlést

Használjon engedélyezett API-fiókot HTTPS kapcsolaton, egy engedélyezett forrás-IP-címről. A márkának ehhez a fiókhoz kell tartoznia. Kérje le és őrizze meg az azonosítóját és az aktuális állapotát, majd ellenőrizze a kampányait és a szám-hozzárendeléseit. Válassza le az érintett számokat, és inaktiválja a kampányokat a márka törlése előtt. Ezt a DELETE műveletet ne tekintse kaszkádműveletnek.

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

Törölje az ellenőrzött márkát

Az alábbi parancsot csak a tervezett kivezetéshez hajtsa végre, miután ellenőrizte a márka azonosítóját és elvégezte az előző rendezési lépéseket. A kérésnek nincs JSON-törzse.

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"

A dokumentált sikeres eredmény HTTP 204, választörzs nélkül. Ne követeljen meg sikert jelző JSON-objektumot vagy a régi v3 status/response válaszburkolatot. Egy elutasított, nem 2xx eredmény a jelenlegi API-szinkronizációs útvonalon nem jelöli töröltként a márkát.

A tervezett kéréshez egyetlen idempotenciakulcsot használjon. Ismételt elküldéskor hagyja változatlanul a metódust, az útvonalat, a lekérdezést és a törzs bájtjait. A kulcs nem teszi atomivá a portál teljes rendezési folyamatát, és nem bizonyítja, hogy egy számot leválasztottak a távközlési szolgáltatónál. Egy még folyamatban lévő kérés ismétlése 409 választ adhat Retry-After fejléccel; a befejezett kérések a mentett válaszukat adhatják vissza újra, beleértve a hibát is.

Ellenőrizze a kivezetést, és egyeztesse a részleges eredményeket

A művelet után ellenőrizze a portál márka- és kampánylistáit, valamint az érintett számokat. A nyilvános API sikeres művelet utáni szinkronizációja az adott márkát helyben töröltként jelöli meg; nem távolítja el a többi kampányerőforrást, és nem törli a megvásárolt számok hozzárendeléseit. A nyilvántartásbeli állapotot, a szolgáltatói hozzárendelést és a helyi megjelenítést külön kell ellenőrizni.

A portál jelenlegi szolgáltatói adaptere elfogadja a sikeres HTTP-választ anélkül, hogy külön ellenőrizné a törzsében szereplő összes üzletiállapot-értéket. Ezért a portál rendezési folyamata után ellenőrizze az érintett számok tényleges kampány-hozzárendeléseit akkor is, ha a portál sikert jelzett. Ha egy hozzárendelés vagy állapot nem következetes, őrizze meg az érintett azonosítókat, és forduljon az ügyfélszolgálathoz, mielőtt a kivezetett konfiguráción keresztül üzenetet küldene vagy újra létrehozná azt.

HTTP 400 esetén olvassa el a nyilvántartás részletes hibaüzenetét, különösen az aktív kampányokra vonatkozó korlátozást. 401, 403 vagy 404 esetén ellenőrizze a hitelesítési adatokat, az engedélyezett forrás-IP-címet és azt, hogy a márka a fiók tulajdonában van-e. 429 esetén tartsa be a Retry-After fejlécben előírt várakozást. Időtúllépés, 500 vagy 502 egy már befejezett külső módosítás után is előfordulhat; a kérés megismétlése előtt vizsgálja meg a meglévő regisztrációt.

Ellenőrizze a fiók fennmaradó díjait

A jelenlegi DELETE szolgáltatás nem indít azonnali márkaregisztrációs díjterhelést. A márka törlése nem szabadítja fel a bérelt telefonszámokat, nem eredményez visszatérítést, és nem állapítja meg a fiók végleges egyenlegét. Tekintse át a portálon a meglévő kampányokhoz kapcsolódó kötelezettségvállalásokat, a számbérleti díjakat és a használati díjakat. Ez a művelet nem minősül az említett külön szolgáltatásokra vonatkozó árajánlatnak.