Mesajlaşma markasını kullanımdan kaldırma

Kullanımdan kaldırma iş akışını seçin

İşletmenin ilgili kayda artık ihtiyacı kalmadığında mesajlaşma markasını kullanımdan kaldırın. Bu işlem mevcut kaydın kullanımını sonlandırır; yerine yeni bir kayıt oluşturmaz, kiralanan telefon numaralarını serbest bırakmaz veya işletmenin kimlik bilgilerini düzeltmez. Düzeltme yapmak için şu işlemi kullanın: Mesajlaşma markasını güncelleme.

Dışa açık marka DELETE çağrısının kapsamı ile portaldaki Markayı sil işleminin kapsamı farklıdır. Dışa açık çağrı, sicildeki tek bir markayı siler. Portal, markayı silmeyi denemeden önce numaraların bağlantılarının kaldırılmasını ve kampanyaların devre dışı bırakılmasını koordine eder.

Portaldaki etkileri inceleyin

Mesajlaşma kayıt sayfasını açın, doğru markayı bulun ve Markayı sil seçeneğini seçin. İlişkili kampanyaların ve atanmış numaraların sayılarını inceleyin. Son işlemi etkinleştirmek için marka kimliğini eksiksiz ve doğru biçimde yazın. Müşteri formu yalnızca hesabın kayıt yönetimi iznine sahip olması durumunda kullanılabilir.

Portal etkin kampanyaları sırayla işler: o anda atanmış her numaranın bağlantısını kaldırmayı dener, kampanyayı devre dışı bırakır ve ardından markayı siler. Süresi dolmuş veya silinmiş olarak işaretlenmiş kampanyalar için yeniden uzaktan silme işlemi yapmaz. Bu harici adımlar başarıyla tamamlandıktan sonra yerel kampanya ve numara kayıtlarını bir veritabanı işlemi içinde günceller.

Bu adımlar sicil, operatör ve yerel kayıtlar genelinde tek bir atomik işlem oluşturmaz. Daha sonra oluşan bir hata, harici sistemde zaten değiştirilmiş bir numarayı veya kampanyayı önceki durumuna döndüremez. Döndürülen yanıtta mevcutsa bağlantısı kaldırılan numaralara ve devre dışı bırakılan kampanyalara ilişkin ayrıntıları saklayın; başka bir marka oluşturmak yerine bu kimliklere ait durumları karşılaştırıp tutarsızlıkları giderin.

Doğrudan API üzerinden silme işlemine hazırlanın

Etkinleştirilmiş bir API hesabını, izin verilen bir kaynak IP adresinden HTTPS üzerinden kullanın. Marka bu hesaba ait olmalıdır. Markanın kimliğini ve mevcut durumunu okuyup saklayın, ardından kampanyalarını ve numara atamalarını kontrol edin. Etkilenen numaraların bağlantılarını kaldırın ve kampanyaları devre dışı bırakın; bunları markayı silmeden önce tamamlayın. Bu DELETE çağrısını zincirleme bir işlem olarak değerlendirmeyin.

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

İncelediğiniz markayı silin

Aşağıdaki komutu yalnızca amaçlanan kullanımdan kaldırma işlemi için, marka kimliğini kontrol ettikten ve yukarıdaki temizleme işlemlerini tamamladıktan sonra çalıştırın. İstekte JSON gövdesi yoktur.

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"

Belgelenen başarılı sonuç, yanıt gövdesi olmadan HTTP 204 döndürülmesidir. Bir JSON başarı nesnesi veya eski v3 status/response yanıt zarfını zorunlu tutmayın. Reddedilen, 2xx dışındaki bir sonuç, mevcut API eşitleme yolu üzerinden markayı silinmiş olarak işaretlemez.

Amaçlanan istek için tek bir idempotans anahtarı kullanın. İsteği yeniden gönderirken yöntemi, yolu, sorguyu ve gövde baytlarını değiştirmeyin. Bu anahtar, portalın daha kapsamlı temizleme işlemini atomik hale getirmez ve operatördeki bir numaranın bağlantısının kaldırıldığını kanıtlamaz. Hâlen işlenmekte olan bir isteğin kopyası, Retry-After başlığıyla 409 döndürebilir; tamamlanmış istekler ise hata dahil, kaydedilmiş yanıtlarını yeniden döndürebilir.

Kullanımdan kaldırmayı doğrulayın ve kısmi sonuçlardaki tutarsızlıkları giderin

İşlemden sonra portaldaki marka ve kampanya listelerini ve etkilenen numaraları kontrol edin. Dışa açık API üzerinden başarılı işlem sonrasında yapılan eşitleme, ilgili markayı yerel olarak silinmiş işaretler; diğer kampanya kaynaklarını kaldırmaz veya satın alınmış numaraların atamalarını temizlemez. Sicil durumu, operatör ataması ve yerel görünüm ayrı ayrı kontrol edilmelidir.

Portaldaki mevcut operatör bağdaştırıcısı, gövdedeki her iş durumu değerini ayrı ayrı doğrulamadan bir HTTP başarı yanıtını kabul eder. Bu nedenle, portal başarı bildirmiş olsa bile portal temizleme işleminden sonra etkilenen numaraların gerçek kampanya atamalarını doğrulayın. Bir atama veya durumda tutarsızlık varsa ilgili kimlikleri saklayın ve kullanımdan kaldırılan yapılandırma üzerinden mesaj göndermeden veya bu yapılandırmayı yeniden oluşturmadan önce destek ekibiyle iletişime geçin.

HTTP 400 durumunda, özellikle etkin kampanya kısıtlamasına ilişkin olanlar olmak üzere ayrıntılı sicil hatasını okuyun. 401, 403 veya 404 durumunda kimlik bilgilerini, izin verilen kaynak IP adresini ve markanın hesaba ait olduğunu kontrol edin. 429 durumunda Retry-After başlığına uyun. Harici bir değişiklik tamamlandıktan sonra da zaman aşımı, 500 veya 502 oluşabilir; isteği yinelemeden önce mevcut kaydı inceleyin.

Hesapta kalan ücretleri kontrol edin

Mevcut DELETE hizmeti, marka kaydı için anında borç kaydı oluşturma işlemi başlatmaz. Bir markanın silinmesi, kiralanan telefon numaralarını serbest bırakmaz, para iadesi sağlamaz veya nihai hesap bakiyesini belirlemez. Portaldaki mevcut kampanya taahhütlerini, numara kiralama ve kullanım ücretlerini inceleyin. Bu işlem, söz konusu ayrı hizmetler için bir fiyat teklifi değildir.