Vyberte postup vyřazení
Značku pro zasílání zpráv vyřaďte, pokud firma již danou registraci nepotřebuje. Tím se ukončí používání stávající registrace; nezaregistruje se náhradní značka, neuvolní se pronajatá telefonní čísla ani se neopraví identifikační údaje firmy. K opravě použijte postup Aktualizace značky pro zasílání zpráv.
Veřejné volání DELETE pro značku a akce Odstranit značku v portálu mají odlišný rozsah. Veřejné volání odstraní jednu značku z registru. Portál koordinuje odpojení čísel a deaktivaci kampaní, než se pokusí značku odstranit.
| Postup | Co provádí |
|---|---|
| Portál: Odstranit značku | Zobrazí související kampaně a přiřazená čísla, vyžádá si identifikátor značky jako potvrzení a poté se před odstraněním značky pokusí provést související vyčištění. Pokud některý pozdější krok selže, dřívější kroky mohou zůstat dokončené. |
| API: DELETE /tcr/v2/brand/{brandId} | Požádá pouze o odstranění této značky vlastněné účtem. Automaticky neodpojuje čísla ani nedeaktivuje kampaně značky. Aktivní kampaň může odstranění zabránit. |
Zkontrolujte dopady v portálu
Otevřete stránku registrace pro zasílání zpráv, vyhledejte správnou značku a zvolte Odstranit značku. Zkontrolujte počty souvisejících kampaní a přiřazených čísel. Zadáním přesného identifikátoru značky zpřístupněte závěrečnou akci. Zákaznický formulář je dostupný pouze tehdy, když má účet oprávnění ke správě registrací.
Portál zpracovává aktivní kampaně postupně: pokusí se odpojit každé aktuálně přiřazené číslo, deaktivuje kampaň a poté odstraní značku. U kampaní, které jsou již označené jako prošlé nebo odstraněné, vynechá další vzdálené odstranění. Po úspěšném dokončení těchto externích kroků aktualizuje místní záznamy kampaní a čísel v databázové transakci.
Tento sled kroků nepředstavuje jednu atomickou transakci zahrnující registr, operátora a místní záznamy. Pozdější selhání nemůže obnovit číslo ani kampaň, které již byly změněny v externím systému. Pokud jsou k dispozici vrácené údaje o odpojených číslech a deaktivovaných kampaních, uchovejte je; namísto vytváření další značky ověřte a sjednoťte stav položek s těmito identifikátory.
Připravte přímé odstranění prostřednictvím API
Použijte povolený účet API a připojení přes HTTPS z povolené zdrojové IP adresy. Značka musí patřit tomuto účtu. Načtěte a uchovejte její identifikátor a aktuální stav, poté zkontrolujte její kampaně a přiřazení čísel. Odpojte dotčená čísla a deaktivujte kampaně před odstraněním značky. Nepovažujte toto volání DELETE za kaskádovou operaci.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Odstraňte zkontrolovanou značku
Následující příkaz spusťte pouze pro zamýšlené vyřazení, po kontrole identifikátoru značky a dokončení předchozího vyčištění. Požadavek nemá tělo ve formátu 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"Dokumentovaným úspěšným výsledkem je HTTP 204 bez těla odpovědi. Nevyžadujte objekt potvrzující úspěch ve formátu JSON ani starší obálku v3 status/response. Zamítnutý výsledek mimo řadu 2xx neoznačí značku jako odstraněnou prostřednictvím současného synchronizačního mechanismu API.
Pro zamýšlený požadavek použijte jeden klíč idempotence. Při opakování ponechte metodu, cestu, dotaz i bajty těla beze změny. Klíč nezajišťuje atomicitu celého vyčištění v portálu a nedokazuje, že bylo číslo u operátora odpojeno. Duplicitní požadavek, jehož zpracování již probíhá, může vrátit 409 s Retry-After; dokončené požadavky mohou znovu vrátit uloženou odpověď, včetně chyby.
Ověřte vyřazení a sjednoťte dílčí výsledky
Po operaci zkontrolujte seznamy značek a kampaní v portálu a dotčená čísla. Synchronizace po úspěšném volání veřejného API označí jednotlivou značku jako odstraněnou v místních záznamech; neodstraňuje ostatní prostředky kampaní ani neruší přiřazení zakoupených čísel. Stav v registru, přiřazení u operátora a místní zobrazení je nutné ověřit samostatně.
Současný adaptér portálu pro operátora přijímá úspěšnou odpověď HTTP, aniž by samostatně ověřoval každou hodnotu provozního stavu v jejím těle. Proto po vyčištění v portálu ověřte skutečná přiřazení dotčených čísel ke kampaním, i když portál ohlásil úspěch. Pokud přiřazení nebo stav nesouhlasí, uchovejte dotčené identifikátory a kontaktujte podporu, než prostřednictvím vyřazené konfigurace začnete odesílat zprávy nebo ji znovu vytvoříte.
U HTTP 400 si přečtěte podrobnou chybu registru, zejména omezení kvůli aktivní kampani. U 401, 403 nebo 404 zkontrolujte přihlašovací údaje, povolenou zdrojovou IP adresu a vlastnictví v rámci účtu. U 429 dodržte Retry-After. K vypršení časového limitu nebo odpovědi 500 či 502 může dojít i po dokončené externí změně; před opakováním požadavku zkontrolujte stávající registraci.
Zkontrolujte zbývající poplatky účtu
Současná služba DELETE neodesílá pokyn k okamžitému stržení poplatku za registraci značky. Odstranění značky neuvolní pronajatá telefonní čísla, nezajistí vrácení peněz ani neurčí konečný zůstatek účtu. V portálu zkontrolujte veškeré stávající závazky související s kampaněmi, pronájem čísel a poplatky za využití. Tato operace nepředstavuje cenovou nabídku těchto samostatných služeb.