Bir markanın inceleme sonuçlarını kontrol edin

Kontrol edeceğiniz markayı seçin

Hesabınızdaki marka kimliğini kullanın. Bir işletmenin incelemesinin başka bir işletmenin incelemesiyle karıştırılmaması için bu kimliği elde edilen inceleme kayıtlarıyla birlikte saklayın. Başka bir hesabın tanımlayıcılarını kullanmayın.

Mevcut bir incelemeyi takip edin

Şu alanları saklayın: vettingId, evpId, vettingClass ve vettingStatus (varsa). Mevcut eşitleme işlemi, PENDING ve UNSCORE durumlarını hâlâ ek kontrol bekleyen sonuçlar olarak, ACTIVE ve FAILED durumlarını ise ücretin hesaplaşması açısından nihai sonuçlar olarak değerlendirir. Ek işlem gerekip gerekmediğine karar vermeden önce döndürülen ayrıntıları okuyun. Boş bir liste tek başına, önceki bir başvurunun kayıt kuruluşuna ulaşmadığının kanıtı değildir.

Önceki bir siparişin ücretlerini anlayın

Durumu kontrol etmek başka bir inceleme siparişi vermez. Ancak tamamlanmış bir sonucu mutabık hâle getirebilir ve daha önceki ücretli bir inceleme talebine bağlı ücretin hesaplaşmasını gerçekleştirebilir. Bu, geçerli olması durumunda başarısızlık ücretini de kapsar. Sipariş sırasında gözden geçirilen fiyat ve koşulları esas alın; eski bir örnekten veya durum yanıtından bugünkü fiyatı çıkarmayın.

Başka bir sipariş vermeden okumayı yeniden deneyin

Geçici bir hata durumunda marka kimliğini ve bilinen inceleme kimliklerini saklayın; Retry-After başlığındaki bekleme süresine uyun ve bu okuma işlemini giderek artan bekleme aralıklarıyla yeniden deneyin. Yalnızca durum sorgusu başarısız olduğu veya beklenmeyen bir yanıt gövdesi döndürdüğü için yeni bir inceleme siparişi vermeyin. Uyuşmazlık devam ederse ilgili referans kimlikleriyle, kimlik doğrulaması gerektiren bir destek kanalı üzerinden MultiTEL ile iletişime geçin.

Kayıt adımlarını ayrı tutun

İnceleme, marka için bir değerlendirme sonucu oluşturur. Kampanya uygunluğunun belirlenmesi, kampanya kaydı ve numara ataması ayrı adımlar olmaya devam eder. Mesaj göndermeden önce bu adımların güncel durumlarını ve gerekliliklerini kontrol edin.

İstek

İzin verilen bir kaynak IP adresinden, HTTPS üzerinden etkin bir API hesabı kullanın. Kayıt kuruluşunun kimlik bilgilerini değil, kendi hesabınızın kimlik bilgilerini kullanın. Marka, kimliği doğrulanmış hesapla ilişkili olmalıdır.

Yolda marka kimliği ve zorunlu vettingStatus sorgu filtresi bulunan bir GET isteği kullanın. Gözden geçirilen şema bir durum dizisi tanımlar; bu örnek tek bir ACTIVE değeri ister. Bu kılavuz, birden fazla değerin nasıl kodlanacağını veya sağlayıcının filtresiz istekleri kabul ettiğini doğrulamaz. İstek gövdesi gerekmez.

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

Yanıt

Mevcut yol, eski v3 yanıt zarfını kullanmak yerine kayıt kuruluşunun HTTP durumunu ve yanıt gövdesini korur. Kısaltılmış, kurgusal dizi, yerel eşitleme akışının kullandığı alanları gösterir; kayıt kuruluşundan alınarak kaydedilmiş bir yanıt veya eksiksiz olduğu garanti edilen bir şema değildir. Kayıtları okumadan önce HTTP durumunu ve JSON içeriğini kontrol edin. Her vettingId değerini seçilen markayla birlikte saklayın.

Örnek yanıt yapısıdır; canlı hesap verisi veya güncel bir fiyat teklifi değildir.

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

Hatalar

• 401: Hesap kimlik doğrulaması başarısız oldu. Kimlik bilgilerini, API erişiminin etkin olup olmadığını ve geçerli kaynak IP kısıtlamalarını kontrol edin.
• 404: Marka bu hesapla ilişkili değildir veya kayıt kuruluşu markayı bulamamıştır. Hesaba ait olma koşulu nedeniyle verilen ret, kayıt kuruluşuna istek gönderilmeden önce gerçekleşir.
• 429: Hesabın veya kayıt kuruluşunun istek sınırına ulaşıldı. Retry-After başlığındaki bekleme süresine uyun ve giderek artan bekleme aralıkları kullanın.
• 502/503: Aktarım, kayıt kuruluşu, istek sınırlayıcı veya yerel işleme kullanılamıyor. Bir hata, önceki bir inceleme talebinin başarısız olduğunu kanıtlamaz.

Kullanılabilirlik ve yan etkiler

• Bu GET isteği yeni bir inceleme siparişi vermez. Kayıt kuruluşundaki sonuçları alır, isteğe ilişkin denetim kayıtları yazar ve saklanan sonuçları eşitler.
• Tamamlanmış bir sonucun okunması, daha önce verilmiş ücretli bir inceleme siparişinin ücret hesaplaşmasını gerçekleştirebilir. Başarısız bir inceleme için, geçerli olması durumunda başarısızlık ücreti uygulanabilir. Sipariş verirken fiyat ve koşulları gözden geçirin; bu okuma işlemi bir fiyat teklifi değildir.
• Bu GET isteğiyle içe aktarılan, yeni keşfedilmiş bir kayıt otomatik olarak yeni bir ücretli sipariş şeklinde sınıflandırılmaz.
• Başarılı veya ACTIVE durumundaki bir inceleme sonucu; kampanya onayı, telefon numarası ataması ya da mesaj gönderme izni anlamına gelmez.