Harici marka incelemesi sipariş etme

Hesaba ait bir mesajlaşma markası kullanın

İzin verilen bir kaynak IP adresinden, HTTPS üzerinden etkinleştirilmiş bir API hesabı kullanın. Basic ve Bearer kimlik doğrulaması desteklenir. Marka kimliği bu hesaba ait olmalıdır. Sağlayıcı belirteçlerini, marka kimlik verilerini ve döndürülen raporları gizli tutun.

Yeni bir harici kontrol sipariş edin

Bir inceleme sağlayıcısının bu marka için yeni bir kontrol yapmasını istediğinizde POST kullanın. Zaten bir sağlayıcı sonucunuz varsa bunun yerine şu işlemi kullanın: içe aktarma. Bu işlem şundan ayrıdır: marka kimliğini yeniden doğrulama.

Önce markanın mevcut kaydını okuyun ve kimlik bilgilerini doğrulayın. Desteklenen sağlayıcıyı ve sınıfı seçmek için şu kaynağı kullanın: güncel kataloglar; ardından ilgili sağlayıcının gereksinimlerini kontrol edin. Her sağlayıcı her sınıfı desteklemez. Siyasi incelemeye ilişkin ek ayrıntılar örnek verilerden oluşmamalı, gerçek kuruluşu veya kampanyayı açıklamalıdır.

Sağlayıcı isteğini hazırlayın

Harici inceleme siparişinin alanları
Alan	Değer
evpId	Güncel harici inceleme sağlayıcı kataloğundan alınan zorunlu sağlayıcı kimliği; 1–10 karakter.
vettingClass	Satın almayı amaçladığınız desteklenen sınıf; açıkça seçin ve fiyatını doğrulayın.
additionalRequestPayload	Sağlayıcıya özgü ayrıntıları içeren, JSON biçiminde kodlanmış bir dize; siyasi inceleme için zorunludur. Dış JSON nesnesinin içindeki bir dizedir, iç içe bir nesne değildir. Gerekli tüm ayrıntıları seçilen sağlayıcıyla doğrulayın.

Başarılı ve başarısız sonuç ücretlerini doğrulayın

24 Ekim 2026 tarihinde okunan, ABD doları cinsinden güncel perakende ücretleri. Gerçek bir sipariş vermeden önce güncel tutarı doğrulayın. Ön ödemeli bakiyenin yeterliliği, başarılı sonuç fiyatına göre kontrol edilir; satın alımlar etkinleştirilmiş olmalıdır.

Harici inceleme için yapılandırılmış sonuç ücretleri
Sınıf	Etkin sonuç	Başarısız sonuç
STANDARD	$46.12	$5.56
ENHANCED	$112.78	$6.67
POLITICAL	$73.34	$24.45
Express talepli POLITICAL	$106.67	$24.45
AUTHPLUS	$13.89	$13.89
RCS	$83.34	$83.34

Bekleyen siparişler başarılı ve başarısız sonuç tutarlarını korur; ACTIVE veya FAILED sonucu eşitlendiğinde hesapları kapatılır. Son iki sınıfta her iki nihai sonuç için de aynı yapılandırılmış ücret kullanılır. Anında alınan bir nihai sonucun ücreti, sipariş yanıtı sırasında tahsil edilebilir. Daha sonraki durum eşitlemesi, bekleyen bir ücretin tahsilatını tamamlayabilir.

mock:true ayarını ücretsiz harici inceleme garantisi olarak kullanmayın. Mevcut harici inceleme hesap kapatma akışı yine de bu siparişi kaydedebilir ve ücretlendirebilir. Bu talimatlar test için gerçek bir satın alım gerektirmez; ücretli bir kontrole yetki vermeyi amaçlayana kadar çevrimdışı test verileri kullanın.

Gözden geçirilmiş tek bir sipariş gönderin

vetting-order.json dosyasını sağlayıcı kimliği, sınıf ve gerekli tüm ek bilgilerle hazırlayın. Dosya, gerçekten göndermeyi amaçladığınız isteği içerir. Dosyayı gizli tutun.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @vetting-order.json \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"

Gerçek sonucu takip edin

Başarılı bir HTTP yanıtı, bekleyen bir inceleme kaydı içerebilir. Kaydın vettingId değerini saklayın; vettingStatus değerini, gerekçeleri, puanı ve varsa geçerlilik başlangıç ve bitiş tarihlerini inceleyin. PENDING ve UNSCORE daha fazla takip gerektirir; ACTIVE, FAILED ve EXPIRED farklı sonuçları belirtir. Yalnızca HTTP düzeyinde kabul edilmiş olması, olumlu bir puanı veya kampanya uygunluğunu kanıtlamaz.

Şu işlevi kullanın: harici inceleme durumu; böylece kaydı takip edebilirsiniz. Nihai bir sonucun okunması veya içe aktarılması, önceki bir ücretli siparişin tahsilatını tamamlayabilir; bu işlem, mevcut ve henüz tahsil edilmemiş bir ücretten mutlaka muaf değildir.

Amaçlanan aynı isteği yeniden deneyin

Amaçlanan her işlem için tek bir Idempotency-Key kullanın; yöntemi, yolu, sorguyu ve gövde baytlarını tam olarak koruyun. Anahtarlar, boşluk içermeyen 1–128 yazdırılabilir ASCII karakterini destekler. Hâlâ devam eden bir isteğin yinelenmesi, Retry-After başlığıyla birlikte 409 döndürebilir. Tamamlanan istekler, hatalar da dâhil olmak üzere saklanan yanıtlarını yeniden döndürür. İstek hızı sınırlarına uyun.

Bir aktarım hatasının ardından önbelleğe alınmış bir 502 yanıtı gelebilir. requestId içeren, önbelleğe alınmış bir 500 yanıtı, kayıt sisteminin işlemi kabul ettiği ancak yerel kalıcı kaydın veya faturalandırmanın başarısız olduğu anlamına gelebilir. İstek kimliğini saklayın, mevcut kayıtları inceleyin ve yeni bir anahtar kullanmadan önce destek ekibiyle kayıtları karşılaştırarak durumu netleştirin. Hatanın, hiçbir sipariş bulunmadığı anlamına geldiğini varsaymayın.