Извеждане от употреба на марка за съобщения

Изберете процедурата за извеждане от употреба

Изведете марка за съобщения от употреба, когато фирмата вече не се нуждае от тази регистрация. Това прекратява използването на съществуващата регистрация; не регистрира заместваща марка, не освобождава наети телефонни номера и не коригира идентификационните данни на фирмата. За корекция използвайте Актуализиране на марка за съобщения.

Публичното извикване DELETE за марка и действието „Изтриване на марка“ в портала имат различен обхват. Публичното извикване изтрива една марка от регистъра. Порталът координира премахването на присвояванията на номера и деактивирането на кампании, преди да опита да изтрие марката.

Прегледайте последствията в портала

Отворете страницата за регистрация за съобщения, намерете правилната марка и изберете „Изтриване на марка“. Прегледайте броя на свързаните кампании и присвоените номера. Въведете точния идентификатор на марката, за да активирате окончателното действие. Формулярът за клиента е достъпен само когато акаунтът има разрешение за управление на регистрации.

Порталът обработва активните кампании последователно: опитва да премахне присвояването на всеки текущо присвоен номер, деактивира кампанията и след това изтрива марката. За кампании, които вече са отбелязани като изтекли или изтрити, пропуска повторното изтриване в отдалечената система. След като тези външни стъпки завършат успешно, актуализира локалните записи за кампаниите и номерата в рамките на транзакция в базата данни.

Тази последователност не е една атомарна транзакция, обхващаща регистъра, оператора и локалните записи. По-късна грешка не може да възстанови предишното състояние на номер или кампания, които вече са променени във външна система. Запазете върнатите данни за номерата с премахнати присвоявания и деактивираните кампании, когато са налични; проверете и съгласувайте състоянието за тези идентификатори, вместо да създавате друга марка.

Подгответе директно изтриване чрез API

Използвайте активиран API акаунт през HTTPS от разрешен изходен IP адрес. Марката трябва да принадлежи на този акаунт. Прочетете и запазете нейния идентификатор и текущото ѝ състояние, след което проверете кампаниите ѝ и присвояванията на номера. Премахнете присвояванията на засегнатите номера и деактивирайте кампаниите преди да изтриете марката. Не разглеждайте това извикване DELETE като каскадна операция.

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

Изтрийте проверената марка

Изпълнете следното само за предвиденото извеждане от употреба, след като проверите идентификатора на марката и завършите предходното премахване на присвоявания и деактивиране на кампании. Заявката няма тяло във формат 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"

Документираният успешен резултат е HTTP 204 без тяло на отговора. Не изисквайте JSON обект за успех или остарялата v3 обвивка на отговора status/response. Отхвърлен резултат със статус извън диапазона 2xx не отбелязва марката като изтрита чрез текущия механизъм за синхронизация на API.

Използвайте един ключ за идемпотентност за предвидената заявка. При повторно изпращане запазете метода, пътя, параметрите на заявката и байтовете на тялото непроменени. Ключът не прави по-широката процедура за премахване на свързани данни в портала атомарна и не доказва, че присвояването на номер при оператора е премахнато. Дублирана заявка, чиято обработка е в ход, може да върне 409 с Retry-After; при завършени заявки може отново да се върне запазеният им отговор, включително грешка.

Проверете извеждането от употреба и съгласувайте частичните резултати

След операцията проверете списъците с марки и кампании в портала и засегнатите номера. Синхронизацията след успешно извикване на публичния API отбелязва отделната марка като изтрита локално; не премахва останалите ресурси на кампаниите и не изчиства присвояванията на закупени номера. Статусът в регистъра, присвояването при оператора и локалното показване се проверяват поотделно.

Текущият адаптер на портала за оператора приема успешен HTTP отговор, без да проверява отделно всяка стойност на бизнес статуса в тялото му. Затова след премахване на свързаните данни през портала проверете действителните присвоявания на засегнатите номера към кампании, дори ако порталът е отчел успех. Ако присвояване или статус е несъгласуван, запазете засегнатите идентификатори и се свържете с поддръжката, преди да изпращате съобщения чрез изведената от употреба конфигурация или да я създавате отново.

При HTTP 400 прочетете подробната грешка от регистъра, особено ограничение поради активна кампания. При 401, 403 или 404 проверете данните за удостоверяване, разрешения изходен IP адрес и принадлежността на марката към акаунта. При 429 спазвайте Retry-After. Изтичане на времето за изчакване, 500 или 502 може да настъпи след завършена промяна във външна система; прегледайте съществуващата регистрация, преди да повторите заявката.

Проверете оставащите начисления по акаунта

Текущата услуга DELETE не задейства незабавно начисляване на такса за регистрация на марка. Изтриването на марка не освобождава наетите телефонни номера, не води до възстановяване на суми и не определя окончателното салдо по акаунта. Прегледайте в портала всички съществуващи ангажименти по кампании, наеми на номера и такси за потребление. Тази операция не представлява ценова оферта за тези отделни услуги.