Hesaba ait bir mesajlaşma markası kullanın
İzin verilen bir kaynak IP adresinden, HTTPS üzerinden etkin 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.
Mevcut bir sağlayıcı sonucunu kullanın
Desteklenen bir sağlayıcının mevcut inceleme sonucunu markanızla ilişkilendirmek için PUT kullanın. Bu işlem yeni bir inceleme sipariş etmez. Doğru sağlayıcı işlem kimliğini ve varsa onay belirtecini doğrudan ilgili sağlayıcıdan alın ve raporun aynı işletme kimliğine ait olduğundan emin olun.
AUTHPLUS bu içe aktarma iş akışını desteklemez. Sağlayıcıya özgü eşleştirme kuralları geçerliliğini korur; bir içe aktarma isteği bu kurallardan muafiyet sağlamaz ve her kampanya kullanım senaryosu için uygunluğu garanti etmez.
İçe aktarmayı hazırlayın
| Alan | Değer |
|---|---|
| evpId | Desteklenen sağlayıcının kimliği, 1–10 karakter. |
| vettingId | Sağlayıcının gerçek inceleme işlemi kimliği, en fazla 255 karakter. Bunun yerine marka kimliğini kullanmayın veya bir kimlik uydurmayın. |
| vettingToken | Sağlayıcı gerektirdiğinde kullanılan onay belirteci, en fazla 65535 karakter. Bunu gizli bilgi olarak koruyun ve sağlayıcı gerektirmediğinde göndermeyin. |
Gerçek sağlayıcı değerlerini kullanarak vetting-import.json dosyasını oluşturun. Yalnızca yanıtta yer alan puan, durum veya zaman damgası alanlarını, sonucu değiştirebilirlermiş gibi göndermeyin.
Sonucu bir kez içe aktarın
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Mevcut ücretlendirmeyi anlayın
Bu aracı sunucu, yeni içe aktarılan bir sonucu yeni bir ücretli sipariş olarak kaydetmez. Bu işlem daha önce sipariş edilmiş bir incelemeyi iptal etmez: aynı vettingId için zaten sonuç veya ücret tahsilatı bekleyen bir sipariş varsa, ACTIVE veya FAILED durumundaki bir sonucun içe aktarılması, sipariş için kayıtlı ücretin tahsil edilmesini sağlayabilir. Bu eşitleme dalı, daha önce ücreti tahsil edilmiş bir kaydı yeniden ücretlendirmez.
Gerçek sonucu takip edin
Başarılı bir HTTP yanıtı, beklemede olan bir inceleme kaydı içerebilir. Kaydın vettingId değerini saklayın ve vettingStatus alanını, gerekçeleri, puanı ve mevcutsa yürürlük ve sona erme tarihlerini inceleyin. PENDING ve UNSCORE ek takip gerektirir; ACTIVE, FAILED ve EXPIRED farklı sonuçları ifade eder. Yalnızca HTTP düzeyinde kabul, olumlu bir puanı veya kampanya uygunluğunu kanıtlamaz.
Kaydı takip etmek için harici inceleme durumu sayfasını kullanın. Nihai duruma ulaşmış bir sonucu okumak veya içe aktarmak, önceki bir ücretli siparişin ücretinin tahsil edilmesini sağlayabilir; bu işlem, mevcut ve henüz ödenmemiş bir ücretin tahsilinden mutlaka muaf değildir.
Aynı amaçlanan isteği yeniden deneyin
Amaçlanan her işlem için bir Idempotency-Key kullanın ve yöntemi, yolu, sorguyu ve gövdenin baytlarını aynen koruyun. Anahtarlar, boşluk içermeyen 1–128 yazdırılabilir ASCII karakterini destekler. Devam eden bir isteğin tekrarı, Retry-After başlığıyla birlikte 409 döndürebilir. Tamamlanan istekler, hatalar da dâhil olmak üzere kayıtlı yanıtlarını yeniden döndürür. İstek sıklığı sınırlarına uyun.
Bir iletim 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 durumu netleştirin. Hatanın hiçbir sipariş bulunmadığı anlamına geldiğini varsaymayın.