Gunakan merek perpesanan milik akun
Gunakan akun API yang diaktifkan melalui HTTPS dari IP sumber yang diizinkan. Autentikasi Basic dan Bearer didukung. ID merek harus milik akun tersebut. Jaga kerahasiaan token penyedia, data identitas merek, dan laporan yang dikembalikan.
Pesan pemeriksaan eksternal baru
Gunakan POST jika Anda memerlukan penyedia pemeriksaan untuk melakukan pemeriksaan baru atas merek ini. Jika Anda sudah memiliki hasil dari penyedia, gunakan impor sebagai gantinya. Proses ini terpisah dari verifikasi ulang identitas merek.
Baca data merek saat ini dan konfirmasikan informasi identitasnya terlebih dahulu. Pilih penyedia/kelas yang didukung dari katalog terkini dan periksa persyaratan penyedia tersebut. Tidak semua penyedia mendukung setiap kelas. Detail tambahan untuk pemeriksaan politik harus menjelaskan organisasi atau kampanye yang sebenarnya, bukan data contoh.
Siapkan permintaan untuk penyedia
| Kolom | Nilai |
|---|---|
| evpId | ID penyedia wajib dari katalog penyedia pemeriksaan eksternal terkini, sepanjang 1–10 karakter. |
| vettingClass | Kelas yang didukung yang ingin Anda beli; pilih secara eksplisit dan konfirmasikan harganya. |
| additionalRequestPayload | String berformat JSON berisi detail khusus penyedia, wajib untuk pemeriksaan politik. Nilainya berupa string di dalam objek JSON terluar, bukan objek bersarang. Konfirmasikan semua detail yang diperlukan dengan penyedia yang dipilih. |
Konfirmasikan biaya untuk hasil berhasil dan gagal
Biaya ritel terkini dalam dolar AS, dilihat pada 24 Oktober 2026. Konfirmasikan jumlah terkini sebelum membuat pesanan sungguhan. Kecukupan dana prabayar diperiksa berdasarkan harga untuk hasil berhasil; pembelian harus diaktifkan.
| Kelas | Hasil aktif | Hasil gagal |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL dengan permintaan Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Pesanan tertunda tetap menyimpan jumlah biaya untuk hasil berhasil/gagal dan diselesaikan penagihannya saat hasil ACTIVE atau FAILED disinkronkan. Dua kelas terakhir menggunakan biaya terkonfigurasi yang sama untuk kedua hasil akhir. Hasil akhir yang langsung tersedia dapat dikenai biaya saat respons pesanan diberikan. Sinkronisasi status berikutnya dapat menyelesaikan tagihan yang tertunda.
Jangan gunakan mock:true sebagai jaminan pemeriksaan eksternal gratis. Alur penyelesaian tagihan pemeriksaan eksternal saat ini tetap dapat mencatat dan menagih pesanan tersebut. Petunjuk ini tidak mengharuskan pembelian sungguhan untuk pengujian; gunakan data uji luring yang telah disiapkan sampai Anda bermaksud mengizinkan pemeriksaan berbayar.
Kirim satu pesanan yang telah ditinjau
Siapkan vetting-order.json dengan ID penyedia, kelas, dan informasi tambahan yang diperlukan. Berkas ini berisi permintaan sebenarnya yang hendak dikirim. Jaga kerahasiaannya.
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"Pantau hasil yang sebenarnya
Respons HTTP yang berhasil dapat berisi catatan pemeriksaan yang tertunda. Simpan vettingId catatan tersebut dan periksa vettingStatus, alasan, skor, serta tanggal mulai berlaku/kedaluwarsa jika tersedia. PENDING dan UNSCORE memerlukan tindak lanjut; ACTIVE, FAILED, dan EXPIRED menunjukkan hasil yang berbeda. Penerimaan HTTP saja tidak membuktikan skor yang baik atau kelayakan kampanye.
Gunakan status pemeriksaan eksternal untuk memantau catatan tersebut. Membaca atau mengimpor hasil akhir dapat menyelesaikan penagihan pesanan berbayar sebelumnya; tindakan ini belum tentu bebas dari tagihan tertunggak yang sudah ada.
Coba kirim ulang permintaan yang sama
Gunakan satu Idempotency-Key untuk setiap operasi yang dimaksud dan simpan metode, jalur, kueri, serta bita isi permintaan secara persis. Kunci mendukung 1–128 karakter ASCII yang dapat dicetak tanpa spasi. Duplikat permintaan yang masih diproses dapat mengembalikan 409 dengan Retry-After. Permintaan yang telah selesai mengembalikan ulang respons yang tersimpan, termasuk kesalahan. Patuhi batas laju permintaan.
Respons 502 yang tersimpan dalam cache dapat muncul setelah kegagalan transportasi data. Respons 500 yang tersimpan dalam cache dengan requestId dapat berarti registri telah menerima operasi tersebut, tetapi penyimpanan permanen lokal atau penagihan gagal. Simpan ID permintaan, periksa catatan terkini, dan lakukan rekonsiliasi bersama tim dukungan sebelum menggunakan kunci baru. Jangan menganggap kesalahan tersebut berarti tidak ada pesanan.