Panduan pengembang
Bangun alat otomatisasi link building Anda dengan BlogDrip API
Hubungkan perangkat lunak Anda langsung ke BlogDrip dan otomatisasikan pemesanan guest post. Bangun alur kerja SEO kustom, integrasikan aplikasi yang sudah Anda gunakan, dan kelola operasi link building dengan lebih efisien.
Mengapa mengotomatisasi
Mengapa membuat alat otomatisasi link building sendiri
Agensi SEO dan tim pemasaran internal menghadapi pola operasional yang sama: mencari peluang publikasi secara manual, memasukkan ulang pesanan guest post, mengelola banyak kampanye klien, memindahkan informasi antar sistem internal, memantau kemajuan pesanan, dan mencoba mensekalakan semua ini tanpa meningkatkan jumlah staf secara proporsional.
Integrasi API mengambil pekerjaan mekanis berulang dari tim Anda dan mengarahkannya melalui kode. Perangkat lunak yang sudah Anda gunakan — CRM, alat manajemen kampanye, atau dasbor kustom tempat tim Anda bekerja setiap hari — berbicara langsung ke marketplace. Operator tetap fokus pada strategi, brief, dan pengendalian kualitas alih-alih memasukkan pesanan.
Otomatisasi memberikan efisiensi alur kerja, bukan peringkat SEO. Ini tidak akan membuat kampanye yang buruk berhasil, dan tidak akan menggantikan penilaian manusia dalam memilih publisher. Yang dilakukannya dengan baik adalah menghilangkan lapisan pemasukan data, sehingga ketika Anda memutuskan apa yang akan dibeli, Anda dapat mengeksekusinya dalam volume apa pun.
Apa yang bisa Anda bangun
Yang dapat Anda bangun dengan BlogDrip API
Pola praktis untuk perangkat lunak yang dibangun di atas integrasi marketplace secara programatik.
Dasbor guest post kustom
Aplikasi internal yang terhubung ke BlogDrip dan mengirimkan pesanan guest post yang didukung melalui UI yang dikendalikan tim Anda.
Sistem manajemen agensi SEO
Pemesanan guest post terhubung ke alur kerja agensi yang sudah ada, sehingga manajer kampanye tidak pernah meninggalkan sistem yang mereka gunakan.
Pengiriman pesanan otomatis
Permintaan API membuat pesanan guest post yang didukung secara batch, tanpa langkah pemasukan data manual per pesanan.
Manajemen kampanye klien
Hubungkan data klien dan kampanye internal ke alur pemesanan BlogDrip — satu sumber kebenaran tentang siapa membeli apa.
Otomatisasi alur kerja
Pemicu operasi API yang didukung dari proses bisnis internal — persetujuan, kick-off, gelombang kampanye terjadwal.
Pelaporan dan pemantauan
Tarik informasi terkait pesanan ke alat pelaporan kustom jika didukung. Batasi cakupan pelaporan pada apa yang sebenarnya diekspos oleh API daripada mengasumsikan visibilitas real-time penuh.
Arsitektur
Contoh arsitektur otomatisasi
Integrasi yang sehat memisahkan tanggung jawab ke dalam empat lapisan.
Di bagian atas, aplikasi otomatisasi eksternal Anda — dasbor kustom, perangkat lunak agensi SEO, CRM internal, atau sistem manajemen kampanye. Di sinilah tim Anda bekerja sehari-hari.
Di bawahnya berada backend aplikasi Anda. Tanggung jawabnya adalah hal-hal yang harus benar pada setiap integrasi: menyimpan `x-client-id` dan `x-client-secret` dengan aman, memvalidasi input sebelum mencapai BlogDrip, menyiapkan dan mengirim permintaan API, menangani respons `{ data, pagination }`, mencatat kejadian operasional, dan mengelola retry dengan aman sehingga gangguan jaringan sementara tidak berubah menjadi pesanan berbayar duplikat.
Dari sana, permintaan mencapai BlogDrip Advertiser API — surface publik dengan versi di bawah `/api/public/*` — yang mengekspos fungsionalitas pemesanan guest post yang didukung.
API mengarahkan pesanan ke marketplace BlogDrip — lebih dari 275,000+ situs web sebagai total inventaris — dan dari sana ke pemrosesan pesanan dan alur publikasi yang berlaku. Bergantung pada situs yang dipilih, publikasi mungkin dilakukan manual di sisi publisher atau otomatis melalui plugin WordPress atau Agency API. Tidak setiap situs dalam marketplace mendukung Instant Publishing, jadi integrasi Anda harus menganggap waktu publikasi bergantung pada alur kerja, bukan instan.
Buat alat otomatisasi Anda, langkah demi langkah
Delapan langkah dari perencanaan hingga pemantauan. Perlakukan ini sebagai referensi, bukan urutan ketat — banyak langkah berjalan secara paralel.
Tentukan alur kerja otomatisasi Anda
Identifikasi tugas mana yang harus diotomatisasi, informasi apa yang dibutuhkan aplikasi Anda, kapan pesanan harus dikirimkan, bagaimana mencegah pesanan duplikat, bagaimana menanggapi kesalahan, dan bagaimana data kampanye disimpan. Contoh ruang lingkup konkret: sebuah agensi yang menangani 20 klien, masing-masing dengan 3–5 kampanye aktif, ingin kampanye baru secara otomatis menghasilkan pesanan untuk daftar situs yang sudah disetujui — tetapi hanya setelah seorang manusia menyetujui brief kampanye.
Dapatkan akses BlogDrip API
Buka akun Anda di app.blogdrip.com/settings dan masuk ke Pengaturan Saya → Akses API untuk menemukan kredensial Anda. Anda akan melihat dua nilai: `x-client-id` dan `x-client-secret`. Secret ditampilkan satu kali saat diterbitkan atau dirotasi, jadi salin segera ke pengelola secret Anda. Akses memerlukan minimal €500 per bulan dalam total pengeluaran akun — pesanan manual dihitung, pesanan API dihitung, kedua jalur digabungkan. Akses API dinonaktifkan secara otomatis jika ambang minimum tidak terpenuhi dalam suatu bulan. €500 adalah ambang pengeluaran, bukan biaya langganan API terpisah.
Baca dokumentasi API
Dokumentasi resmi di app.blogdrip.com/api/public/docs/index.html menjelaskan endpoint tepat di bawah namespace `/api/public/*`, autentikasi (dua header yang disebutkan di atas), metode permintaan, parameter yang diperlukan, format respons (endpoint daftar membungkus respons dalam `{ data, pagination }` dengan paging 0-based `?page=0`), kesalahan validasi (`{ message }`), dan operasi pemesanan yang tersedia. Anggap dokumentasi sebagai sumber otoritatif: jika suatu parameter tidak didokumentasikan, jangan menganggapnya ada.
Bangun koneksi API
Buat backend aplikasi yang menyimpan `x-client-id` dan `x-client-secret` dengan aman (variabel lingkungan, secret manager — jangan pernah di kode frontend), mengirim permintaan terautentikasi dengan kedua header, mengurai respons, menangani kesalahan, dan menulis log terstruktur untuk setiap panggilan keluar. Jaga klien API sebagai modul kecil yang teruji sehingga bagian lain dari aplikasi Anda tidak berbicara langsung ke BlogDrip.
Implementasikan pemesanan guest post otomatis
Hubungkan alur kerja internal Anda ke operasi pemesanan BlogDrip yang didukung. Alur tipikal: kampanye baru dibuat di sistem Anda → sebuah situs web dipilih (selesaikan `marketSiteId` dari endpoint marketplace) → aplikasi Anda menyiapkan informasi pesanan yang diperlukan (judul, URL, deskripsi, `categoryId`, `marketSiteId`, `campaignId`, `scheduleDate` opsional, `linkNoFollow`) → backend memvalidasi pesanan sesuai aturan bisnis Anda → aplikasi mengirimkan pesanan melalui Advertiser API → respons disimpan di sistem Anda untuk keterlacakan. Validasi setiap field terhadap spesifikasi OpenAPI sebelum mengirim.
Tangani kesalahan dan pesanan duplikat
Validasi permintaan sebelum pengiriman, cegah pesanan duplikat yang tidak disengaja (kunci idempodensi atau pemeriksaan deduplikasi sisi server adalah pola aman), catat setiap kegagalan API dengan konteks yang cukup untuk debug kemudian, tangani gangguan konektivitas sementara dengan anggun, dan hormati batas laju yang didokumentasikan. Satu aturan yang harus diinternalisasikan: jangan pernah otomatis melakukan retry pada permintaan pembuatan pesanan yang tidak idempoten tanpa konfirmasi eksplisit dari manusia atau sistem — retry pada pesanan yang berhasil tetapi responsnya tidak terlihat akan menciptakan penagihan ganda.
Uji integrasi Anda
Jalankan integrasi Anda terhadap lingkungan sandbox jika ada dalam dokumentasi. Jika tidak ada sandbox, uji terhadap produksi dengan hati-hati — jangan pernah menjalankan suite tes otomatis yang membuat pesanan berbayar nyata tanpa otorisasi eksplisit. Gunakan kampanye uji khusus dengan peninjauan manusia sebelum pesanan otomatis pertama dikirim, dan batasi tes otomatis ke daftar pendek situs yang telah Anda setujui sebelumnya untuk pengujian integrasi.
Deploy dan pantau
Pindahkan kredensial ke penyimpanan secret produksi Anda, tambahkan pemantauan untuk kegagalan integrasi dan pola pengiriman pesanan yang tidak biasa, lacak hasil pengiriman pesanan secara end-to-end, simpan log operasional cukup lama untuk men-debug insiden dua minggu sebelumnya, pantau pengeluaran akun Anda agar tidak kehilangan akses API karena turun di bawah minimum €500 per bulan, dan perhatikan changelog BlogDrip untuk pembaruan API yang mungkin memerlukan pemeliharaan integrasi.
Pola integrasi
Seperti apa integrasi yang sehat
Sumber otoritatif untuk contoh yang dapat dieksekusi adalah spesifikasi OpenAPI di app.blogdrip.com/api/public/openapi.json dan dokumentasi yang dapat dibaca manusia di /api/public/docs. Spesifikasi adalah acuan yang harus digunakan kode Anda — bukan potongan landing page yang bisa kadaluwarsa.
Dalam praktiknya, integrasi yang rapi cenderung mengikuti bentuk yang sama. Modul klien API tipis dalam bahasa pilihan Anda — satu fungsi pembungkus per operasi yang Anda butuhkan — menangani mekanika: menetapkan header `x-client-id` dan `x-client-secret` pada setiap permintaan, melakukan serialisasi body permintaan, mendeserialisasi amplop `{ data, pagination }` pada endpoint daftar (paging 0-based), dan mengubah respons kesalahan (`{ message }`) menjadi pengecualian yang dapat ditangani logika bisnis Anda dengan rapi. Setiap pembungkus memiliki setidaknya satu tes yang menegaskan bentuk yang didokumentasikan, sehingga perubahan skema muncul sebagai tes yang gagal sebelum mencapai produksi. Hanya setelah modul itu stabil Anda menghubungkannya ke bagian lain aplikasi — pemicu kampanye, antrean pesanan, pekerja retry, pelaporan.
Urutan itu menjaga integrasi dapat diaudit: klien API Anda adalah area permukaan kecil yang teruji; semua yang lain berbicara ke BlogDrip melalui modul itu.
Praktik terbaik
Apa yang membuat integrasi API bertahan lama
Pola yang menjaga sistem otomatis tetap sehat jauh setelah hari peluncuran.
Idempotensi sebagai desain
Anggap pembuatan pesanan mahal dan tidak dapat dibalik. Lakukan deduplikasi di sisi Anda sebelum permintaan dikirim — jangan setelahnya.
Higiene kredensial
Kredensial API harus disimpan di secret manager, dipisahkan per lingkungan. Rotasi saat seseorang meninggalkan tim, bukan hanya saat terjadi kebocoran.
Pencatatan terstruktur
Setiap pasangan permintaan + respons mendapat ID korelasi. Anda yang men-debug pesanan lama akan berterima kasih pada Anda yang membuat log sekarang.
Klien sadar rate limit
Hormati batas laju yang didokumentasikan. Klien yang mundur dengan rapi akan mampu diskalakan lebih jauh daripada yang melakukan retry agresif.
Keterlibatan manusia
Lindungi panggilan produksi pertama di balik persetujuan manusia. Perluas otomatisasi hanya setelah integrasi terbukti stabil.
Pemantauan pengeluaran
Berikan peringatan ketika pengeluaran akun bulanan mendekati atau di bawah €500. Kehilangan akses API di tengah kampanye sangat menyulitkan.
Pertanyaan yang sering diajukan
Untuk siapa BlogDrip API ini?
Akun pengiklan yang ingin menghubungkan perangkat lunak mereka sendiri — dasbor kustom, platform agensi SEO, CRM internal — ke alur pemesanan guest post BlogDrip. Pengguna tipikal adalah agensi yang mengelola kampanye dalam jumlah besar, tim SEO internal yang mengintegrasikan dengan tumpukan yang ada, dan pengembang yang membangun alat operasional untuk klien atau produk tertentu.
Apakah saya harus menjadi pengembang untuk menggunakan API?
Untuk membangun integrasinya, ya. API adalah antarmuka programatik — menggunakan API memerlukan penulisan kode atau bekerja dengan pengembang. Jika Anda menginginkan manfaat operasional tanpa pekerjaan integrasi, UI marketplace mencakup fungsionalitas pemesanan yang sama secara manual.
Apa persyaratan aksesnya?
Akun BlogDrip aktif yang menghabiskan setidaknya €500 per bulan secara total — pesanan manual dan API keduanya dihitung untuk ambang tersebut. Akses API dinonaktifkan secara otomatis jika akun Anda menghabiskan lebih sedikit pada bulan tertentu. €500 adalah ambang volume, bukan biaya langganan API terpisah.
Di mana dokumentasi API?
Dokumentasi API resmi dipublikasikan di app.blogdrip.com/api/public/docs/index.html, dengan spesifikasi OpenAPI yang dapat dibaca mesin di app.blogdrip.com/api/public/openapi.json. Keduanya menjelaskan skema autentikasi, daftar lengkap endpoint di bawah namespace `/api/public/*`, bentuk permintaan dan respons, format paginasi, dan respons kesalahan. Anggap keduanya sebagai sumber kebenaran untuk integrasi Anda.
Di mana saya menemukan kredensial API saya?
Di Pengaturan Saya → Akses API pada app.blogdrip.com/settings. Anda akan mendapatkan `x-client-id` dan `x-client-secret`; keduanya masuk ke setiap permintaan terautentikasi sebagai header HTTP. Secret ditampilkan satu kali saat diterbitkan atau dirotasi — salin segera ke secret manager Anda, karena tidak dapat diambil kembali. Kredensial bersifat per-akun; perlakukan seperti secret lainnya dan jangan masukkan ke version control.
Bagaimana cara kerja paginasi pada endpoint daftar?
Endpoint daftar membungkus respons mereka dalam amplop `{ data, pagination }` dan menggunakan paging 0-based — kirim `?page=0` untuk halaman pertama, `?page=1` untuk halaman kedua, dan seterusnya. Blok pagination dalam respons memberi tahu apakah masih ada halaman berikutnya. Jika Anda bermigrasi dari antarmuka legacy `/api/<path>`, bentuk respons tidak berubah — hanya path dasar yang pindah ke `/api/public/*`.
Apakah API mendukung webhooks?
Periksa spesifikasi OpenAPI di app.blogdrip.com/api/public/openapi.json untuk daftar mekanisme callback atau notifikasi event yang didukung saat ini. Jika sebuah fitur tidak tercantum, bangun integrasi Anda tanpa menganggapnya ada — polling API sesuai jadwal Anda sendiri adalah fallback yang aman.
Apakah ada lingkungan sandbox?
Jawaban otoritatif ada di dokumentasi API saat ini. Jika sandbox tercantum, gunakan untuk pengujian integrasi. Jika tidak tercantum, jangan buat pesanan berbayar nyata selama pengujian otomatis tanpa otorisasi eksplisit — gunakan kampanye uji khusus dan peninjauan manusia sebagai gantinya.
Dapatkah pesanan API menggunakan Instant Publishing?
Ketersediaan Instant Publishing bergantung pada situs yang dipilih memiliki integrasi publikasi otomatis yang didukung (baik plugin BlogDrip untuk WordPress atau koneksi Agency API). Pesanan apapun — API atau manual — yang ditempatkan pada situs yang memenuhi syarat dapat memanfaatkan publikasi otomatis. Tidak setiap situs di marketplace mendukungnya, jadi integrasi Anda harus menganggap waktu publikasi berbeda per situs, bukan seragam.
Apa perbedaan antara Advertiser API dan Agency API?
Advertiser API ditujukan untuk pelanggan yang ingin mengotomatisasi pemesanan guest post dari perangkat lunak mereka sendiri. Agency API untuk agensi eksternal, platform link building, dan jaringan publisher yang ingin menghubungkan inventaris mereka sendiri ke BlogDrip dan mengotomatisasi pemenuhan yang didukung. Keduanya berdiri sendiri — menggunakan satu tidak mengharuskan penggunaan yang lain.
Apa yang terjadi jika saya melakukan retry pada permintaan pembuatan pesanan yang gagal?
Jika Anda tidak melihat respons yang dikonfirmasi, anggap permintaan pertama mungkin saja berhasil di sisi server. Jangan otomatis melakukan retry pada pembuatan pesanan yang tidak idempoten. Tambahkan kunci deduplikasi sisi server, atau kueri untuk pesanan yang mungkin sudah dibuat sebelum melakukan retry — mana pun yang didukung alur kerja Anda dengan rapi. Retry pada pesanan yang berhasil tetapi tidak terlihat akan menciptakan penagihan ganda.
Siap mengotomatisasi link building Anda?
Buka dokumentasi API, hasilkan kredensial Anda, dan mulai bangun. Marketplace diskalakan oleh otomatisasi Anda — bukan sebaliknya.