Ingin aplikasi Anda membaca data backlink dari website yang terdaftar di Bing Webmaster Tools? Panduan ini menjelaskan cara mendapatkan API key, memastikan situs terverifikasi, menguji koneksi, dan mengambil rincian tautan masuk melalui JSON/REST dengan tetap menjaga kerahasiaan kunci akun.
PANDUAN DIVISI ELECTRONIC BUSINESS PT MSP
Hubungkan aplikasi dengan data backlink website Anda
API key adalah kunci akses yang digunakan aplikasi ketika meminta data dari suatu layanan. Dengan Bing Webmaster API, pengembang dapat membantu Anda membaca data situs secara terprogram, lalu mengolahnya menjadi laporan atau dashboard.
Dokumentasi diperiksa pada . Nama dan posisi menu dapat berubah mengikuti pembaruan Bing.
Pada artikel sebelumnya, MSP membahas cara mendapatkan API key PageSpeed Insights melalui Google Cloud. Kali ini, kebutuhan kita adalah membaca data tautan masuk atau backlink dari situs yang berada dalam akun Bing Webmaster Tools.
Contohnya, sebuah aplikasi ingin menampilkan halaman website yang memperoleh tautan dari situs lain, alamat halaman pemberi tautan, dan teks yang dipakai pada tautan tersebut. Agar aplikasi dapat meminta data itu, pemilik website perlu menyiapkan akses yang sesuai.
Persiapan sebelum mengambil API key
Siapkan akun yang digunakan untuk mengelola website di Bing Webmaster Tools. Jika situs sudah terdaftar, periksa kembali apakah status kepemilikannya sudah terverifikasi. Website yang baru ditambahkan belum tentu langsung mempunyai laporan backlink.
Jika situs belum terverifikasi, Bing menyediakan impor dari Google Search Console, verifikasi DNS, file XML, atau tag meta. Untuk pengguna Blogger, impor dari Search Console atau tag meta pada bagian <head> tema dapat menjadi pilihan praktis. Tag verifikasi dipasang pada tema website, bukan di isi artikel. Ikuti opsi yang tersedia pada akun Anda. Panduan menambahkan dan memverifikasi situs.
Bedakan tag verifikasi dengan API key. Tag verifikasi membantu Bing memeriksa kepemilikan website. API key digunakan aplikasi untuk mengakses API dan harus disimpan secara rahasia.
Key IndexNow juga mempunyai fungsi tersendiri: memberi tahu mesin pencari tentang URL yang baru, berubah, atau dihapus. Untuk pengambilan backlink dalam artikel ini, gunakan akses Bing Webmaster API. Dokumentasi IndexNow.
Cara mendapatkan API key Bing Webmaster Tools
- Masuk ke Bing Webmaster Tools. Gunakan akun yang memang mengelola situs tujuan. Apabila Anda memiliki beberapa akun, pastikan website yang dimaksud muncul pada daftar situs.
- Periksa verifikasi website. Selesaikan verifikasi bila diperlukan, kemudian buka properti website tersebut.
- Buka Settings. Cari menu pengaturan, lalu pilih API Access.
- Buka bagian API Key. Pada penggunaan pertama, baca ketentuan yang ditampilkan dan lanjutkan jika menyetujuinya.
- Pilih Generate API Key. Jika kunci sudah tersedia, gunakan kunci yang ada. Pengguna tidak perlu membuat kunci baru untuk setiap website.
- Simpan kunci pada tempat yang aman. Masukkan melalui pengaturan rahasia aplikasi atau mekanisme aman yang disediakan pengembang. Pastikan tidak ada spasi tambahan ketika menyalinnya.
Microsoft mendokumentasikan satu API key per pengguna. Kunci tersebut dapat digunakan untuk situs-situs terverifikasi milik pengguna. Lihat Getting Access to the Bing Webmaster Tools API.
Sesudah langkah ini, catat tiga hal untuk konfigurasi aplikasi: penyedia layanan Bing Webmaster API, kunci akses, dan properti website tujuan. Nilai URL properti sebaiknya dikonfirmasi melalui API, seperti dijelaskan pada bagian berikut.
Bagaimana aplikasi mengambil data backlink?
Proses yang disarankan terdiri atas tiga tahap. Pengembang memilih situs yang tepat terlebih dahulu, mengambil daftar halaman tujuan, lalu membaca rincian tautan menuju halaman tersebut.
Pada ponsel, geser tabel ke samping untuk melihat semua kolom.
| Tahap | Metode | Data yang dibaca |
|---|---|---|
| 1. Pilih situs | GetUserSites | Daftar situs pada akun, termasuk Url dan IsVerified. |
| 2. Cari halaman penerima tautan | GetLinkCounts | Links berisi URL halaman website dan Count; TotalPages menunjukkan jumlah halaman hasil API. |
| 3. Ambil rincian tautan | GetUrlLinks | Details berisi Url sumber dan AnchorText, disertai TotalPages. |
Istilah halaman hasil berarti pembagian data API ke beberapa bagian. Ini berbeda dari halaman website. Sebagai contoh, TotalPages = 3 berarti aplikasi perlu memeriksa indeks hasil 0, 1, dan 2.
Untuk siteUrl, gunakan nilai Url yang benar-benar dikembalikan oleh GetUserSites. Perbedaan http, https, www, atau garis miring terakhir perlu diperiksa jika properti tidak ditemukan.
Pada GetUrlLinks, parameter link adalah URL halaman tujuan di website Anda. Ambil nilai itu dari daftar Links. Alamat halaman pemberi tautan baru dibaca dari hasil Details.
Contoh pengujian API untuk pengembang aplikasi
Jika Anda hanya menyiapkan kunci untuk aplikasi yang sudah tersedia, ikuti kolom konfigurasi aplikasi tersebut. Bagian ini ditujukan bagi pengembang yang perlu memastikan akses dasar sebelum membuat dashboard.
Contoh Python 3 berikut dijalankan melalui terminal pada komputer atau server tepercaya. Kunci diminta melalui input tersembunyi, tidak ditulis ke dalam kode. Simpan contoh sebagai uji_bing_backlink.py, kemudian jalankan python uji_bing_backlink.py atau python3 uji_bing_backlink.py, sesuai instalasi Anda.
Cakupan pengujian: pilih satu situs terverifikasi, baca halaman hasil pertama, lalu tampilkan maksimal tiga rincian backlink untuk satu URL tujuan. Contoh ini belum merupakan pengunduh seluruh data.
import getpass
import json
from urllib.error import HTTPError, URLError
from urllib.parse import urlencode
from urllib.request import Request, urlopen
BASE = "https://ssl.bing.com/webmaster/api.svc/json/"
api_key = getpass.getpass("API key Bing (tidak ditampilkan): ").strip()
if not api_key:
raise SystemExit("API key belum diisi.")
def call_api(method, **params):
query = urlencode({"apikey": api_key, **params})
request = Request(BASE + method + "?" + query, headers={
"Accept": "application/json",
"Content-Type": "application/json; charset=utf-8",
})
try:
with urlopen(request, timeout=30) as response:
payload = json.load(response)
except HTTPError as err:
raise SystemExit(
f"HTTP {err.code}. Periksa akses API; jangan bagikan URL request."
) from None
except (URLError, TimeoutError, OSError):
raise SystemExit("Koneksi gagal atau waktu tunggu habis.") from None
except (ValueError, UnicodeError):
raise SystemExit("Respons bukan JSON yang dapat dibaca.") from None
if not isinstance(payload, dict) or "d" not in payload:
raise SystemExit("API melaporkan galat atau format respons berubah.")
return payload["d"]
sites = call_api("GetUserSites")
if not isinstance(sites, list):
raise SystemExit("Format daftar situs tidak sesuai.")
verified = [s for s in sites if isinstance(s, dict)
and s.get("IsVerified") is True and s.get("Url")]
if not verified:
raise SystemExit("Tidak ada situs terverifikasi yang dikembalikan API.")
for number, site in enumerate(verified, 1):
print(number, site["Url"])
try:
choice = int(input("Pilih nomor situs: "))
except ValueError:
raise SystemExit("Nomor situs harus berupa angka.") from None
if not 1 <= choice <= len(verified):
raise SystemExit("Nomor situs di luar daftar.")
site_url = verified[choice - 1]["Url"]
counts = call_api("GetLinkCounts", siteUrl=site_url, page=0)
if not isinstance(counts, dict):
raise SystemExit("Format hasil GetLinkCounts tidak sesuai.")
targets = counts.get("Links") or []
print("Halaman hasil GetLinkCounts:", counts.get("TotalPages"))
if not targets:
raise SystemExit("API belum mengembalikan data tautan pada halaman ini.")
target = targets[0]["Url"]
print("Contoh halaman tujuan:", target)
print("Count dari API:", targets[0].get("Count"))
details = call_api("GetUrlLinks", siteUrl=site_url, link=target, page=0)
if not isinstance(details, dict):
raise SystemExit("Format hasil GetUrlLinks tidak sesuai.")
print("Halaman hasil GetUrlLinks:", details.get("TotalPages"))
print("Maksimal tiga contoh tautan dari halaman hasil pertama:")
print(json.dumps((details.get("Details") or [])[:3],
ensure_ascii=False, indent=2))
Nilai api_key dikirim melalui parameter apikey pada koneksi HTTPS. Fungsi urlencode menangani pengodean parameter URL. Contoh juga membaca pembungkus respons d, sesuai format JSON Bing.
Catatan validasi: contoh mengikuti kontrak metode pada dokumentasi Microsoft. Hasil backlink aktual bergantung pada akun dan data Bing; artikel ini tidak menyajikan hasil pengujian langsung menggunakan kredensial pembaca.
Mengembangkan pengambilan data lebih lanjut
- Ulangi
GetLinkCountsdaripage=0selama nilai halaman masih lebih kecil daripadaTotalPages. - Untuk setiap URL tujuan, ulangi
GetUrlLinksdengan aturan pagination yang sama. - Simpan URL sumber, URL tujuan, teks tautan, waktu pengambilan, dan sumber data. URL tujuan diperoleh dari permintaan aplikasi.
- Atur jeda, antrean pekerjaan, batas percobaan ulang, dan penyimpanan sementara agar permintaan tidak diulang tanpa kebutuhan.
- Tampilkan status pengambilan, termasuk gagal, parsial, atau kosong. Jangan mengganti kegagalan pengambilan menjadi angka nol backlink.
Struktur penyimpanan tersebut merupakan saran rancangan aplikasi. Waktu pengambilan data adalah waktu aplikasi Anda mencatat hasil, bukan bukti kapan backlink pertama kali dibuat atau ditemukan Bing. Pisahkan kedua istilah itu agar laporan mudah dipahami.
Batasan data backlink yang perlu dipahami
Bing menjelaskan bahwa rincian laporan Backlinks berupa kumpulan tautan yang mewakili profil situs, bukan daftar lengkap seluruh backlink. Dashboard juga memiliki batas tampilan atau ekspor tersendiri. Angka batas dashboard tidak boleh langsung digunakan sebagai kuota API. Penjelasan resmi laporan Backlinks.
Karena itu, gunakan label seperti “Backlink yang dikembalikan Bing pada pengambilan ini” dalam aplikasi. Label tersebut menjelaskan ruang lingkup angka yang terlihat dan membantu pengguna menghindari kesimpulan berlebihan.
Dokumentasi metode yang dirujuk di sini tidak menjamin hasilnya identik dengan seluruh fitur dashboard Backlinks. Bandingkan satu situs dan satu URL tujuan terlebih dahulu sebelum menjanjikan kelengkapan data kepada pengguna aplikasi.
Jangan menyamakan jumlah backlink dengan jumlah domain perujuk. Beberapa halaman dari satu domain bisa menghasilkan banyak tautan. Jika aplikasi menghitung domain dari URL sumber, tuliskan bahwa angka itu merupakan hasil pengolahan data yang berhasil diambil.
Artikel ini tidak menetapkan angka kuota harian karena sumber metode yang digunakan tidak memberikan satu angka umum untuk seluruh pengambilan backlink. Ikuti batas layanan dan respons yang berlaku. Kuota pengiriman URL untuk pengindeksan mempunyai tujuan berbeda dari pengambilan data backlink.
Jika API berhasil diakses tetapi data kosong
Geser tabel ke samping bila diperlukan.
| Kondisi | Yang diperiksa | Tindakan |
|---|---|---|
| Situs tidak ada di daftar | Akun pemilik API key dan akses situs. | Jalankan GetUserSites dan cocokkan dengan akun dashboard. |
| Situs belum terverifikasi | IsVerified dan status pada Bing Webmaster. | Selesaikan verifikasi, lalu ulangi pemeriksaan. |
| Daftar tautan kosong | siteUrl, URL tujuan, dan page=0. | Bandingkan dengan laporan Backlinks; tampilkan status data belum tersedia untuk permintaan tersebut. |
| Galat autentikasi atau izin | Kunci yang terpasang, perubahan kunci, dan hak akses akun. | Periksa pesan galat secara internal. Samarkan kunci sebelum membagikan log. |
| Respons 429 atau pembatasan laju | Frekuensi dan jumlah permintaan bersamaan. | Tunda permintaan, hormati Retry-After bila ada, lalu coba ulang secara terbatas. |
| Hasil berbeda dengan dashboard | Situs, URL, waktu pengambilan, dan cakupan kedua laporan. | Catat perbedaan. Gunakan ekspor CSV dashboard sebagai pembanding jika tersedia. |
Status HTTP berhasil hanya menunjukkan permintaan berhasil ditangani pada tingkat tersebut. Aplikasi tetap perlu memeriksa isi JSON dan data yang dikembalikan. Bila masalah berlanjut, kirim nama metode, waktu, kode galat, dan contoh hasil yang sudah disamarkan melalui dukungan Bing Webmaster Tools.
Simpan API key di sisi server aplikasi
Untuk aplikasi yang dipublikasikan melalui website, simpan kunci akun pada server atau layanan pengelola rahasia. Server mengambil data Bing, memeriksa hak akses pengguna aplikasi, kemudian mengirimkan hasil yang diizinkan ke tampilan pengunjung.
- Hindari menaruh kunci dalam HTML Blogspot, JavaScript publik, repositori kode, tangkapan layar, atau dokumen yang dibagikan.
- Samarkan parameter
apikeypada log. URL permintaan lengkap dapat memuat kunci meskipun koneksi menggunakan HTTPS. - Batasi akses ke pengaturan kredensial dan catat aplikasi yang memakai kunci tersebut.
- Jika kunci bocor, lakukan penggantian dan perbarui aplikasi yang bergantung padanya.
Saran penyimpanan dan pengelolaan rahasia ini mengacu pada OWASP Secrets Management Cheat Sheet. Untuk mengganti kunci Bing, ikuti menu penghapusan dan pembuatan ulang pada API Access; kunci lama yang dihapus tidak dapat terus digunakan oleh aplikasi. Panduan penggantian kunci Bing.
Kapan sebaiknya menggunakan OAuth 2.0?
Microsoft merekomendasikan OAuth 2.0 sebagai metode akses. Untuk aplikasi yang dipakai banyak pelanggan, OAuth memungkinkan pengguna memberi izin melalui akun masing-masing. Pengembang perlu menyiapkan pendaftaran aplikasi, pengelolaan token, dan alur persetujuan.
Untuk aplikasi pembaca laporan, mintalah hak baca yang diperlukan. Dokumentasi Bing menjelaskan cakupan Webmaster.read untuk membaca data dan Webmaster.manage untuk membaca serta mengelola data. Ikuti penulisan dan ketentuan pada dokumentasi saat implementasi. Panduan OAuth 2.0 Bing Webmaster.
API key dapat digunakan untuk integrasi internal yang dikendalikan pemilik akun. Namun, rancangan layanan untuk banyak pelanggan sebaiknya mempertimbangkan OAuth sejak awal agar pemberian dan pencabutan izin dapat dikelola dengan jelas.
Pertanyaan yang sering diajukan
Apakah satu API key dapat dipakai untuk beberapa website?
Ya. API key mengikuti pengguna Bing Webmaster Tools dan dapat digunakan untuk situs terverifikasi yang dapat diakses pengguna tersebut. Pastikan situs yang dipilih muncul dalam hasil GetUserSites.
Apakah API ini bisa digunakan untuk memeriksa backlink sembarang domain?
Panduan ini memakai metode untuk situs terverifikasi dalam akun Anda. Fitur pembanding situs lain pada dashboard Backlinks merupakan fitur terpisah; jangan menganggap kemampuan yang sama tersedia melalui metode API yang dibahas di sini.
Apakah API key Bing Webmaster sama dengan key IndexNow?
Keduanya berbeda. Bing Webmaster API digunakan dalam panduan ini untuk membaca data situs. IndexNow digunakan untuk memberi tahu mesin pencari tentang URL yang ditambahkan, diperbarui, atau dihapus.
Mengapa API berhasil diakses tetapi data backlink kosong?
Periksa akun, status verifikasi, siteUrl, URL tujuan, dan penomoran halaman. Hasil kosong menunjukkan API belum mengembalikan data untuk permintaan tersebut; hasil itu belum cukup untuk menyimpulkan website tidak memiliki backlink.
Bolehkah API key dimasukkan ke JavaScript halaman Blogspot?
Simpan kunci akun di server aplikasi atau penyimpanan rahasia yang dikelola pengembang. Kode JavaScript publik dapat dibaca pengunjung. Halaman Blogspot cukup menampilkan hasil yang sudah diizinkan untuk dibagikan.
Apakah contoh kode dalam artikel mengambil semua backlink?
Contoh hanya menguji koneksi, membaca halaman hasil pertama, dan menampilkan maksimal tiga rincian untuk satu URL tujuan. Pengambilan lebih luas memerlukan pagination, pengaturan laju permintaan, serta pemeriksaan batas dan ketersediaan data Bing.
Referensi teknis ditautkan pada bagian yang relevan agar pembaca dapat memeriksa petunjuk terbaru. Contoh dan saran rancangan aplikasi disusun untuk membantu pengujian awal; hasil dan ketersediaan data tetap mengikuti layanan Bing Webmaster Tools.
.aviv)
Tidak ada komentar
Posting Komentar
Silakan ajukan pertanyaan, kritik, maupun saran.