Geliştiriciler

PUT/tcr/v2/brand/{brandId}/revet

Bir mesajlaşma markasını yeniden doğrulama

Mevcut işletme profilini düzelttikten sonra ayrı ücretlendirilen tek bir kimlik kontrolü başvurusu gönderin ve sonucu takip edin.

Bu sayfada
  1. Düzeltilen işletme kimliğini yeniden kontrol edin
  2. Başvuruyu göndermeden önce markayı inceleyin
  3. Ayrı ücreti onaylayın
  4. Planlanan başvuruyu bir kez gönderin
  5. Sonucu okuyun ve durumunu takip edin
  6. Belirsiz bir sonucu netleştirin
  7. Müşteri portalını kullanma

Düzeltilen işletme kimliğini yeniden kontrol edin

Mevcut bir kurumsal markanın düzeltilmiş kimlik bilgilerinin yeniden kontrol edilmesi gerektiğinde bu işlemi kullanın. Önce mevcut markayı güncelleyin, ardından güncel kimlik durumunu sorgulayın. Normal bir profil güncellemesi, ayrı ücretlendirilen bu başvuruyu göndermez. Yeniden doğrulama başka bir marka oluşturmaz veya kampanya kaydı yapmaz.

İzin verilen bir kaynak IP adresinden, HTTPS üzerinden kendi etkin API hesabınızı kullanın. Marka bu hesaba ait olmalıdır. Marka kayıtlarını gizli tutun: bu kayıtlar işletme ve iletişim bilgileri içerir.

Başvuruyu göndermeden önce markayı inceleyin

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

Döndürülen markanın amaçlanan işletmeye ait olduğunu ve düzeltmenin mevcut olduğunu kontrol edin. İlk kayıt işlemi beklemedeyse henüz yeniden doğrulama yapılamaz. İşletme bilgileri değişmemişse kayıt kuruluşu isteği reddedebilir. Eksik özel nitelikler için başka bir kimlik kontrolü yerine itiraz başvurusu gerekebilir. Şahıs işletmesi markaları uygun kimlik/PIN iş akışını kullanır; bu uç noktayı o iş akışının yerine kullanmayın.

Ayrı ücreti onaylayın

Üretim ortamında şu anda yapılandırılmış yeniden doğrulama ücreti: kabul edilen başvuru başına US$5.00, 24 Ekim 2026 tarihinde kontrol edilmiştir. İlk kaydı yapılan tüzel kişinin kayıt ücreti farklı olsa bile standart marka ücreti uygulanır. Satın alma işlemleri etkin olmalıdır; ön ödemeli hesaplarda başvuru gönderilmeden önce yeterli bakiye bulunmalıdır.

202 yanıtı, isteğin işlenmeye devam edilmek üzere kabul edildiği ve ücret tahsilatının kabul anında başlatıldığı anlamına gelir. İşletmenin doğrulandığı anlamına gelmez. Daha sonra yapılacak yeni bir başvuru ek ücrete tabi olabilir. Sırf doğrulama hâlâ beklemede olduğu için yeni bir başvuru oluşturmayın.

Planlanan başvuruyu bir kez gönderin

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"

Profil bilgilerini içeren bir istek gövdesi gerekmez: bu işlem, zaten kaydedilmiş marka bilgilerini kontrol eder. Planlanan başvuru için benzersiz bir idempotans anahtarı kullanın; yeniden denemelerde yöntemi, yolu, sorguyu ve gövdeyi tamamen aynı tutun. Anahtarlar, boşluk içermeyen 1–128 yazdırılabilir ASCII karakterini destekler. İşlenmekte olan bir isteğin tekrarı, Retry-After başlığıyla birlikte 409 döndürebilir; tamamlanmış bir başvuru ise hata dâhil kaydedilmiş sonucunu yeniden döndürebilir.

Genel kullanıma açık API, etkin bir belirteç hesabı için Bearer kimlik doğrulamasını da kabul eder. Hesap sahipliği ve izin verilen kaynak IP adresi kontrolleri yine uygulanır. Kaydedilmiş sahte test markaları bu üretim ortamı ücretlendirme sürecini atlar; ancak korumalı test ortamındaki bir sonuç, üretim ortamında kimlik doğrulaması anlamına gelmez.

Sonucu okuyun ve durumunu takip edin

Yeniden doğrulama yanıtları
YanıtAnlamı ve sonraki işlem
200İstek başarılı oldu. Döndürülen markayı inceleyin ve kimlik durumunu teyit etmek için güncel marka kaydını yeniden sorgulayın.
202Kabul edildi, ek doğrulama bekleniyor. Marka kimliğini saklayın ve ayrı ücretlendirilen başka bir başvuru göndermeden güncel durumunu daha sonra kontrol edin.
400Kayıt kuruluşunun döndürdüğü hataları inceleyin. İlk kayıt beklemede olabilir, profil değişmemiş olabilir veya başka bir geçerlilik denetimi kuralı uygulanıyor olabilir.
401 / 404Kimlik bilgilerini ve izin verilen IP adresini ya da hesaba ait marka kimliğini kontrol edin.
402 / 503Yerel satın alma/bakiye yükleme veya fiyatlandırma/hizmet hatasını inceleyin. Her 503 yanıtının üst hizmete hiçbir istek gönderilmediğini kanıtladığını varsaymayın.
429Retry-After başlığında belirtilen bekleme süresine uyun ve başvuru ayrıntılarını aynı tutun.

Vekil sunucu, kabul edilen bir değişiklikten sonra yerel marka kaydını yeniler; bu yenileme tek başına doğrulamanın nihai sonucunu kanıtlamaz. Bir işletme doğrulanmamış veya beklemede kalabilir. Kampanya kurulumuna devam etmeden önce yalnızca HTTP düzeyindeki kabule değil, markanın güncel durumuna bakın.

Belirsiz bir sonucu netleştirin

Bir iletişim hatası, önbelleğe alınmış bir 502 yanıtına yol açabilir. Üst hizmette kabul edilen bir isteğin ardından yerel kalıcı kaydetme veya faturalandırma hatası oluşursa requestId içeren, önbelleğe alınmış bir 500 yanıtı oluşabilir. Bu tanımlayıcıyı saklayın ve markanın ve faturalandırmanın güncel durumunu destek ekibiyle netleştirin. Başka bir anahtar üretmek, ayrı faturalandırılabilecek bir başvuru oluşturabilir; durumu araştırmadan yeni bir anahtarla yeniden denemeyin.

Müşteri portalını kullanma

Portal, güncel profil ve ücret incelendikten sonra üretim ortamında UNVERIFIED durumundaki bir kuruluş için yeniden doğrulama sunar. Profilin ve fiyatın değişmediğini kontrol eder ve aynı güncel bilgilerle daha önce kabul edilmiş bir başvuru varsa yeni başvuruyu reddeder. Korumalı test ortamı markaları ve şahıs işletmesi markaları bu portal işlemine dâhil değildir.

Portaldaki bu korumalar, ek iş akışı kontrolleridir. Doğrudan API kullanan istemciler kendi incelemelerini yapmalı ve API için portalın sürüm veya fiyat onayı alanlarının zorunlu olduğunu varsaymamalıdır. Normal bir marka düzeltmesini kaydetmek ayrı bir işlemdir ve otomatik olarak yeniden doğrulama başvurusu göndermez.