Periksa hasil verifikasi merek

Pilih merek yang sedang Anda periksa

Gunakan ID merek dari akun Anda. Simpan ID tersebut bersama catatan verifikasi yang dihasilkan agar peninjauan untuk satu bisnis tidak tertukar dengan peninjauan bisnis lain. Jangan gunakan pengenal milik akun lain.

Pantau peninjauan yang sudah ada

Simpan vettingId, evpId, vettingClass dan vettingStatus jika tersedia. Sinkronisasi saat ini memperlakukan PENDING dan UNSCORE sebagai hasil yang masih menunggu pemeriksaan lebih lanjut, serta ACTIVE dan FAILED sebagai hasil akhir untuk penyelesaian biaya. Baca detail yang dikembalikan sebelum memutuskan apakah tindak lanjut diperlukan. Daftar kosong saja bukan bukti bahwa pengajuan sebelumnya tidak sampai ke registri.

Pahami biaya untuk pesanan sebelumnya

Memeriksa status tidak memesan peninjauan lain. Namun, pemeriksaan ini dapat mencocokkan hasil yang telah selesai dan menyelesaikan biaya yang terkait dengan permintaan peninjauan berbayar sebelumnya. Ini mencakup biaya kegagalan yang berlaku. Gunakan harga dan ketentuan yang ditinjau saat melakukan pemesanan; jangan menyimpulkan harga saat ini dari contoh lama atau respons status.

Ulangi pembacaan tanpa mengajukan pesanan lain

Jika terjadi kegagalan sementara, simpan ID merek dan ID verifikasi yang diketahui, patuhi Retry-After dan ulangi pembacaan ini dengan jeda yang meningkat secara bertahap. Jangan mengajukan pesanan peninjauan baru hanya karena pencarian status gagal atau mengembalikan isi respons yang tidak terduga. Jika ketidaksesuaian terus terjadi, hubungi MultiTEL dengan menyertakan ID referensi yang relevan melalui saluran dukungan yang memerlukan autentikasi.

Pisahkan langkah-langkah pendaftaran

Verifikasi menetapkan hasil peninjauan untuk merek. Penentuan kelayakan kampanye, pendaftaran kampanye, dan penetapan nomor tetap merupakan langkah-langkah terpisah. Periksa status dan persyaratan terkini masing-masing sebelum mengirim pesan.

Permintaan

Gunakan akun API yang telah diaktifkan melalui HTTPS dari alamat IP sumber yang diizinkan. Gunakan kredensial akun Anda, bukan kredensial registri. Merek harus terkait dengan akun yang diautentikasi.

Gunakan GET dengan ID merek di jalur dan filter kueri wajib vettingStatus. Skema yang telah ditinjau mendefinisikan larik status; contoh ini meminta satu nilai ACTIVE. Panduan ini tidak memastikan pengodean beberapa nilai maupun penerimaan permintaan tanpa filter oleh penyedia. Isi permintaan tidak diperlukan.

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

Respons

Rute saat ini mempertahankan status dan isi HTTP dari registri alih-alih menggunakan pembungkus respons v3 lama. Larik fiktif yang disingkat ini menggambarkan kolom yang digunakan oleh jalur sinkronisasi lokal; ini bukan respons registri yang direkam atau skema yang dijamin lengkap. Periksa status HTTP dan JSON sebelum membaca catatan. Simpan setiap vettingId bersama merek yang dipilih.

Bentuk respons sebagai ilustrasi; bukan data akun langsung atau penawaran harga terkini.

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

Kesalahan

• 401: Autentikasi akun gagal. Periksa kredensial, apakah API diaktifkan, dan pembatasan IP sumber yang berlaku.
• 404: Merek tidak terkait dengan akun ini, atau registri tidak dapat menemukannya. Penolakan berdasarkan kepemilikan akun terjadi sebelum permintaan dikirim ke registri.
• 429: Batas permintaan akun atau registri telah tercapai. Patuhi Retry-After dan gunakan jeda yang meningkat secara bertahap sebelum mencoba lagi.
• 502/503: Transportasi data, registri, pembatas permintaan, atau pemrosesan lokal tidak tersedia. Kesalahan tidak membuktikan bahwa permintaan peninjauan sebelumnya gagal.

Ketersediaan dan efek samping

• GET ini tidak membuat pesanan verifikasi baru. Permintaan ini mengambil hasil dari registri, menulis catatan audit permintaan, dan menyinkronkan hasil yang tersimpan.
• Membaca hasil yang telah selesai dapat menyelesaikan biaya untuk pesanan verifikasi berbayar yang telah dibuat sebelumnya. Peninjauan yang gagal dapat dikenai biaya kegagalan yang berlaku. Tinjau harga dan ketentuan saat memesan; pembacaan ini bukan penawaran harga.
• Catatan yang baru ditemukan dan diimpor oleh GET ini tidak secara otomatis diklasifikasikan sebagai pesanan berbayar baru.
• Hasil verifikasi yang berhasil atau berstatus ACTIVE bukan persetujuan kampanye, penetapan nomor telepon, atau izin untuk mengirim pesan.