Wycofaj markę używaną do wysyłania wiadomości

Wybierz sposób wycofania marki

Wycofaj markę używaną do wysyłania wiadomości, gdy firma nie potrzebuje już tej rejestracji. Oznacza to zakończenie korzystania z istniejącej rejestracji; nie powoduje zarejestrowania nowej w jej miejsce, zwolnienia wynajmowanych numerów telefonu ani poprawienia danych identyfikacyjnych firmy. Aby poprawić dane, skorzystaj z opcji Zaktualizuj markę używaną do wysyłania wiadomości.

Publiczne wywołanie DELETE dotyczące marki i działanie „Usuń markę” w portalu mają różny zakres. Publiczne wywołanie usuwa jedną markę z rejestru. Portal koordynuje odłączanie numerów i dezaktywację kampanii, zanim podejmie próbę usunięcia marki.

Sprawdź skutki w portalu

Otwórz stronę rejestracji na potrzeby wysyłania wiadomości, znajdź właściwą markę i wybierz „Usuń markę”. Sprawdź liczbę powiązanych kampanii i przypisanych numerów. Wpisz dokładny identyfikator marki, aby umożliwić wykonanie końcowego działania. Formularz klienta jest dostępny tylko wtedy, gdy konto ma uprawnienie do zarządzania rejestracjami.

Portal przetwarza aktywne kampanie kolejno: próbuje odłączyć każdy aktualnie przypisany numer, dezaktywuje kampanię, a następnie usuwa markę. Pomija ponowne usuwanie w systemie zdalnym w przypadku kampanii już oznaczonych jako wygasłe lub usunięte. Po pomyślnym zakończeniu tych zewnętrznych kroków aktualizuje lokalne rekordy kampanii i numerów w ramach transakcji bazy danych.

Ta sekwencja nie stanowi jednej atomowej transakcji obejmującej rejestr, operatora i lokalne rekordy. Późniejsze niepowodzenie nie może przywrócić numeru ani kampanii, które zostały już zmienione w systemie zewnętrznym. Zachowaj zwrócone szczegóły odłączonych numerów i dezaktywowanych kampanii, jeśli są dostępne; uzgodnij stany na podstawie tych identyfikatorów, zamiast tworzyć kolejną markę.

Przygotuj bezpośrednie usunięcie przez API

Użyj aktywnego konta API przez HTTPS z dozwolonego źródłowego adresu IP. Marka musi należeć do tego konta. Odczytaj i zachowaj jej identyfikator oraz aktualny stan, a następnie sprawdź jej kampanie i przypisania numerów. Odłącz numery objęte operacją i dezaktywuj kampanie przed usunięciem marki. Nie traktuj tego wywołania DELETE jako operacji kaskadowej.

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

Usuń sprawdzoną markę

Wykonaj poniższe wywołanie wyłącznie w celu zamierzonego wycofania marki, po sprawdzeniu jej identyfikatora i zakończeniu wcześniejszych działań porządkowych. Żądanie nie zawiera treści w formacie 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"

Udokumentowany wynik pomyślnego wykonania to HTTP 204 bez treści odpowiedzi. Nie wymagaj obiektu sukcesu w formacie JSON ani starszej struktury v3 z polami status/response. Odrzucone żądanie z wynikiem spoza zakresu 2xx nie powoduje oznaczenia marki jako usuniętej przez obecną ścieżkę synchronizacji API.

Użyj jednego klucza idempotencji dla zamierzonego żądania. Przy ponowieniu zachowaj metodę, ścieżkę, parametry zapytania i treść bez zmian, bajt po bajcie. Klucz nie sprawia, że szersze działania porządkowe w portalu stają się atomowe, ani nie dowodzi, że numer został odłączony u operatora. Duplikat nadal przetwarzanego żądania może zwrócić 409 z nagłówkiem Retry-After; w przypadku zakończonych żądań może zostać ponownie zwrócona zapisana odpowiedź, również zawierająca błąd.

Zweryfikuj wycofanie i uzgodnij częściowe wyniki

Po operacji sprawdź listy marek i kampanii w portalu oraz numery objęte operacją. Synchronizacja po pomyślnym wywołaniu publicznego API oznacza pojedynczą markę lokalnie jako usuniętą; nie usuwa pozostałych zasobów kampanii ani nie kasuje przypisań zakupionych numerów. Status w rejestrze, przypisanie u operatora i lokalnie wyświetlane informacje wymagają osobnych kontroli.

Obecny adapter operatora w portalu akceptuje odpowiedź HTTP oznaczającą powodzenie bez osobnego sprawdzania każdej wartości statusu biznesowego w jej treści. Dlatego po działaniach porządkowych w portalu sprawdź rzeczywiste przypisania numerów objętych operacją do kampanii, nawet jeśli portal zgłosił powodzenie. Jeśli przypisanie lub status są niespójne, zachowaj odpowiednie identyfikatory i skontaktuj się z pomocą techniczną, zanim zaczniesz wysyłać wiadomości za pośrednictwem wycofanej konfiguracji lub ją odtworzysz.

W przypadku HTTP 400 przeczytaj szczegółowy komunikat błędu rejestru, zwłaszcza dotyczący ograniczenia związanego z aktywną kampanią. W przypadku 401, 403 lub 404 sprawdź dane uwierzytelniające, dozwolony źródłowy adres IP i przynależność marki do konta. W przypadku 429 zastosuj się do nagłówka Retry-After. Przekroczenie limitu czasu, 500 lub 502 może wystąpić po zakończeniu zmiany w systemie zewnętrznym; sprawdź istniejącą rejestrację przed ponowieniem żądania.

Sprawdź pozostałe opłaty na koncie

Obecna usługa DELETE nie zleca natychmiastowego obciążenia konta za rejestrację marki. Usunięcie marki nie zwalnia wynajmowanych numerów telefonu, nie powoduje zwrotu środków ani nie ustala końcowego salda konta. Sprawdź w portalu wszelkie istniejące zobowiązania dotyczące kampanii oraz opłaty za wynajem numerów i użytkowanie. Ta operacja nie stanowi wyceny tych odrębnych usług.