Panduan pembangun
Bina alat automasi pembinaan pautan anda dengan BlogDrip API
Sambungkan perisian anda terus ke BlogDrip dan automasikan pesanan pos tetamu. Bina aliran kerja SEO tersuai, gabungkan aplikasi sedia ada, dan urus operasi pembinaan pautan dengan lebih cekap.
Mengapa automasi
Mengapa membina alat automasi pembinaan pautan sendiri
Agensi SEO dan pasukan pemasaran dalaman sering mengalami corak operasi yang sama: mencari peluang penerbitan secara manual, memasukkan semula pesanan pos tetamu, mengendalikan berbilang kempen pelanggan, memindahkan maklumat antara sistem dalaman, memantau kemajuan pesanan, dan cuba menambah skala semua ini tanpa menambah tenaga kerja secara sepadan.
Integrasi API mengambil kerja mekanikal yang berulang daripada pasukan anda dan menyalurkannya melalui kod. Perisian sedia ada anda — CRM, alat pengurusan kempen, atau papan pemuka tersuai yang digunakan pasukan anda setiap hari — bercakap terus dengan pasaran. Operator kekal fokus pada strategi, arahan, dan kawalan kualiti bukannya kemasukan pesanan.
Automasi memberikan kecekapan aliran kerja, bukan kedudukan SEO. Ia tidak akan menjayakan kempen yang buruk, dan ia tidak menggantikan penilaian manusia dalam pemilihan penerbit. Apa yang ia lakukan dengan baik ialah menghapuskan lapisan kemasukan data, supaya apabila anda memutuskan apa yang hendak dibeli anda boleh melaksanakannya pada sebarang jumlah.
Apa yang anda boleh bina
Apa yang boleh anda bina dengan BlogDrip API
Corak praktikal untuk perisian yang dibina di atas integrasi pasaran secara programatik.
Papan pemuka pos tetamu tersuai
Aplikasi dalaman yang menyambung ke BlogDrip dan menghantar pesanan pos tetamu yang disokong dari antara muka yang dikawal oleh pasukan anda.
Sistem pengurusan agensi SEO
Pesanan pos tetamu dipautkan ke aliran kerja agensi sedia ada, supaya pengurus kempen tidak perlu meninggalkan sistem yang mereka gunakan.
Penyerahan pesanan automatik
Permintaan API mencipta pesanan pos tetamu yang disokong secara berkumpulan, tanpa langkah kemasukan data manual per pesanan.
Pengurusan kempen pelanggan
Sambungkan rekod pelanggan dan kempen dalaman ke aliran kerja pesanan BlogDrip — satu sumber kebenaran untuk siapa membeli apa.
Automasi aliran kerja
Picu operasi API yang disokong dari proses perniagaan dalaman — kelulusan, pelancaran, gelombang kempen berjadual.
Pelaporan dan pemantauan
Tarik maklumat berkaitan pesanan ke dalam alat pelaporan tersuai apabila disokong. Hadkan pelaporan kepada apa yang API sebenarnya dedahkan dan jangan andaian keterlihatan masa nyata penuh.
Senibina
Contoh senibina automasi
Integrasi yang sihat memisahkan tanggungjawab merentasi empat lapisan.
Di bahagian atas, aplikasi automasi luaran anda — papan pemuka tersuai, perisian agensi SEO, CRM dalaman, atau sistem pengurusan kempen. Di sinilah pasukan anda bekerja setiap hari.
Di bawahnya terletak backend aplikasi anda. Tanggungjawabnya adalah perkara yang setiap integrasi perlu lakukan dengan betul: menyimpan `x-client-id` dan `x-client-secret` dengan selamat, mengesahkan input sebelum ia sampai ke BlogDrip, menyediakan dan menghantar permintaan API, mengendalikan respons `{ data, pagination }`, merekod acara operasi, dan mengurus ulang cuba dengan selamat supaya gangguan rangkaian sementara tidak menjadi pesanan berbayar berganda.
Dari situ, permintaan sampai ke BlogDrip Advertiser API — permukaan awam yang versi di bawah `/api/public/*` — yang mendedahkan fungsi pesanan pos tetamu yang disokong.
API menghala pesanan ke pasaran BlogDrip — lebih daripada 275,000 laman web inventori keseluruhan — dan dari situ ke pemprosesan pesanan dan aliran kerja penerbitan yang berkenaan. Bergantung pada laman web yang dipilih, penerbitan mungkin manual di pihak penerbit atau automatik melalui pemalam WordPress atau Agency API. Tidak setiap laman web dalam pasaran menyokong Penerbitan Segera, jadi integrasi anda harus menganggap masa penerbitan bergantung pada aliran kerja, bukan segera.
Bina alat automasi anda, langkah demi langkah
Lapan langkah dari penykalaan hingga pemantauan. Anggap ia sebagai rujukan, bukan urutan ketat — banyak daripadanya berjalan selari.
Tentukan aliran kerja automasi anda
Kenal pasti tugas mana yang patut diautomasi, maklumat apa aplikasi anda perlukan, bila pesanan perlu dihantar, bagaimana mengelakkan pesanan berganda, bagaimana ralat dikendalikan, dan bagaimana data kempen disimpan. Contoh skop konkrit: sebuah agensi mengurus 20 pelanggan, setiap satu dengan 3–5 kempen aktif, mahu kempen baru menjana pesanan secara automatik untuk senarai pendek laman web yang diluluskan — tetapi hanya selepas seorang manusia meluluskan ringkasan kempen.
Dapatkan akses BlogDrip API
Buka akaun anda di app.blogdrip.com/settings dan pergi ke Tetapan Saya → Akses API untuk mencari kredensial anda. Anda akan melihat dua nilai: `x-client-id` dan `x-client-secret`. Secret dipaparkan sekali apabila ia dikeluarkan atau diputar, jadi salin terus ke pengurus rahsia anda. Akses memerlukan perbelanjaan akaun minima €500 sebulan secara keseluruhan — pesanan manual dikira, pesanan API dikira, kedua-duanya digabungkan. Akses API akan dinyahaktifkan secara automatik jika minimum tidak dipenuhi dalam sebulan tertentu. €500 adalah ambang perbelanjaan, bukan bayaran langganan API berasingan.
Baca dokumentasi API
Dokumentasi rasmi di app.blogdrip.com/api/public/docs/index.html menerangkan titik akhir tepat di bawah ruang nama `/api/public/*`, pengesahan (dua pasangan header yang disebut di atas), kaedah permintaan, parameter diperlukan, format respons (titik akhir senarai membungkus respons dalam `{ data, pagination }` dengan `?page=0` berasaskan 0), ralat pengesahan (`{ message }`), dan operasi pesanan yang tersedia. Anggap dokumentasi sebagai sumber autoritatif: jika sesuatu parameter tidak didokumenkan, jangan anggap ia wujud.
Bina sambungan API
Cipta backend aplikasi yang menyimpan kedua-dua `x-client-id` dan `x-client-secret` dengan selamat (pembolehubah persekitaran, pengurus rahsia — jangan letak dalam kod frontend), menghantar permintaan yang disahkan dengan kedua-dua header ditetapkan, mengurai respons, mengendalikan ralat, dan menulis log berstruktur untuk setiap panggilan keluar. Kekalkan klien API sebagai modul kecil yang diuji dengan baik supaya bahagian lain aplikasi anda tidak bercakap terus dengan BlogDrip.
Laksanakan pesanan pos tetamu automatik
Sambungkan aliran kerja dalaman anda ke operasi pesanan BlogDrip yang disokong. Aliran tipikal: kempen baru dicipta dalam sistem anda → satu laman web dipilih (selesaikan `marketSiteId` dari titik akhir pasaran) → aplikasi anda menyediakan maklumat pesanan yang diperlukan (tajuk, URL, penerangan, `categoryId`, `marketSiteId`, `campaignId`, `scheduleDate` pilihan, `linkNoFollow`) → backend mengesahkan pesanan mengikut peraturan perniagaan anda → aplikasi menghantar pesanan melalui Advertiser API → respons disimpan dalam sistem anda untuk keterjejakkan. Sahkan setiap medan mengikut spesifikasi OpenAPI sebelum menghantar.
Urus ralat dan pesanan berganda
Sahkan permintaan sebelum penghantaran, elakkan pesanan berganda secara tidak sengaja (kunci idempoten atau semakan deduplikasi sisi-server adalah corak selamat), log setiap kegagalan API dengan konteks yang cukup untuk debug kemudian, urus masalah sambungan sementara dengan baik, dan patuhi had kadar yang didokumenkan. Satu peraturan untuk diinternalisasikan: jangan secara automatik ulang cuba permintaan penciptaan pesanan bukan idempoten tanpa pengesahan manusia atau sistem — ulang cuba pada pesanan yang berjaya tetapi tidak anda lihat responsnya akan menghasilkan caj berganda.
Uji integrasi anda
Jalankan integrasi anda terhadap persekitaran sandbox jika ia didokumenkan. Jika tiada sandbox tersedia, uji dengan berhati-hati terhadap produksi — jangan jalankan suite ujian automatik yang mencipta pesanan berbayar sebenar tanpa kebenaran jelas. Gunakan kempen ujian khusus dengan semakan manusia sebelum pesanan automatik pertama dihantar, dan hadkan larian ujian automatik kepada senarai pendek laman web yang telah anda pra-luluskan untuk ujian integrasi.
Deploj dan pantau
Pindahkan kredensial ke stor rahsia produksi anda, tambah pemantauan untuk kegagalan integrasi dan corak penghantaran pesanan yang luar biasa, jejak keputusan penghantaran pesanan hujung-ke-hujung, simpan log operasi cukup lama untuk debug insiden dua minggu, pantau perbelanjaan akaun anda supaya anda tidak kehilangan akses API dengan jatuh di bawah minima €500 sebulan, dan perhatikan changelog BlogDrip untuk kemas kini API yang mungkin memerlukan penyelenggaraan integrasi.
Corak integrasi
Bentuk integrasi yang sihat
Sumber autoritatif untuk contoh boleh dilaksanakan ialah spesifikasi OpenAPI di app.blogdrip.com/api/public/openapi.json dan dokumentasi mesra-manusia di /api/public/docs. Spesifikasi itu adalah apa yang kod anda patut dijana atau disemak terhadapnya — bukan petikan halaman pendaratan yang boleh menjadi lapuk.
Dalam praktik, integrasi yang kemas cenderung mengikuti bentuk yang sama. Modul klien API nipis dalam bahasa pilihan anda — satu fungsi pembungkus untuk setiap operasi yang anda perlukan — mengendalikan mekanik: menetapkan header `x-client-id` dan `x-client-secret` pada setiap permintaan, menyerialkan badan permintaan, menyahserialkan penutup `{ data, pagination }` pada titik akhir senarai (pengepaparan berasaskan 0), dan menukar respons ralat (`{ message }`) menjadi pengecualian yang logik perniagaan anda boleh tangkap dengan bersih. Setiap pembungkus mempunyai sekurang-kurangnya satu ujian yang menegaskan bentuk yang didokumenkan, supaya perubahan skema muncul sebagai ujian gagal sebelum sampai ke produksi. Hanya selepas modul itu stabil anda menyambungkannya kepada baki aplikasi anda — pencetus kempen, barisan pesanan, pekerja ulang cuba, pelaporan.
Susunan itu mengekalkan keboleh-audit integrasi: klien API anda adalah permukaan kecil yang diuji dengan baik; segala-galanya yang lain bercakap dengan BlogDrip melalui modul tersebut.
Amalan terbaik
Apa yang menjadikan integrasi API tahan lama
Corak yang mengekalkan sistem automatik sihat lama selepas hari pelancaran.
Idempoten sebagai reka bentuk
Anggap penciptaan pesanan sebagai mahal dan tidak boleh dibalik. Lakukan deduplikasi di pihak anda sebelum permintaan dihantar — bukan selepas.
Kebersihan kredensial
Kredensial API patut disimpan dalam pengurus rahsia, dilaraskan mengikut persekitaran. Putar mereka ketika pekerja keluar, bukan hanya ketika berlaku kebocoran.
Logging berstruktur
Setiap pasangan permintaan + respons diberi ID korelasi. Masa akan datang anda yang sedang debug pesanan lama akan berterima kasih kepada anda hari ini.
Klien sedar had kadar
Hormati had kadar yang didokumenkan. Klien yang mundur dengan kemas boleh diskalakan lebih jauh daripada yang mengulang cuba secara agresif.
Manusia dalam gelung
Lindungi panggilan produksi pertama di belakang kelulusan manusia. Kembangkan automasi hanya selepas integrasi terbukti stabil.
Pemantauan perbelanjaan
Berikan amaran apabila perbelanjaan akaun bulanan menghampiri atau di bawah €500. Kehilangan akses API di tengah kempen menyakitkan.
Soalan Lazim
Siapa yang sesuai menggunakan BlogDrip API?
Akaun pengiklan yang mahu menyambungkan perisian mereka sendiri — papan pemuka tersuai, platform agensi SEO, CRM dalaman — ke aliran kerja pesanan pos tetamu BlogDrip. Pengguna tipikal ialah agensi yang mengurus kempen berskala besar, pasukan SEO dalaman yang menggabungkan dengan sistem sedia ada, dan pembangun yang membina alat operasi untuk pelanggan atau produk tertentu.
Perlukah saya menjadi pembangun untuk menggunakan API?
Untuk membina integrasi itu sendiri, ya. API adalah antara muka programatik — menggunakannya memerlukan menulis kod atau bekerjasama dengan pembangun. Jika anda mahukan manfaat operasi tanpa kerja integrasi, antara muka pasaran membolehkan fungsi pesanan yang sama secara manual.
Apakah keperluan akses?
Akaun BlogDrip aktif yang membelanjakan sekurang-kurangnya €500 sebulan secara keseluruhan — pesanan manual dan API kedua-duanya dikira ke arah ambang. Akses API dinyahaktifkan secara automatik jika akaun anda membelanjakan kurang pada bulan tertentu. €500 adalah ambang volum, bukan yuran langganan API berasingan.
Di manakah dokumentasi API?
Dokumentasi API rasmi diterbitkan di app.blogdrip.com/api/public/docs/index.html, dengan spesifikasi OpenAPI boleh dibaca mesin di app.blogdrip.com/api/public/openapi.json. Kedua-duanya menerangkan skim pengesahan, katalog titik akhir penuh di bawah ruang nama `/api/public/*`, bentuk permintaan dan respons, format pengepaginan, dan respons ralat. Anggap mereka sebagai sumber kebenaran untuk integrasi anda.
Di mana saya mencari kredensial API saya?
Di Tetapan Saya → Akses API di app.blogdrip.com/settings. Anda akan mendapat `x-client-id` dan `x-client-secret`; kedua-duanya masuk ke setiap permintaan yang disahkan sebagai header HTTP. Secret dipaparkan sekali apabila ia dikeluarkan atau diputar — salin terus ke pengurus rahsia anda kerana ia tidak boleh diambil semula kemudian. Kredensial adalah per-akaun; layaninya seperti rahsia lain dan jangan simpan dalam kawalan versi.
Bagaimana pengepaginan berfungsi pada titik akhir senarai?
Titik akhir senarai membungkus respons mereka dalam penutup `{ data, pagination }` dan menggunakan pengepaginan berasaskan 0 — hantar `?page=0` untuk halaman pertama, `?page=1` untuk yang kedua, dan seterusnya. Blok pengepaginan dalam respons memberitahu anda sama ada halaman tambahan wujud. Jika anda berpindah dari antara muka legacy `/api/<path>`, bentuk respons tidak berubah — hanya laluan asas berpindah ke `/api/public/*`.
Adakah API menyokong webhooks?
Semak spesifikasi OpenAPI di app.blogdrip.com/api/public/openapi.json untuk senarai semasa mekanisme callback atau pemberitahuan acara yang disokong. Jika sesuatu ciri tidak disenaraikan, bina integrasi anda tanpa menganggap ia wujud — polling API mengikut jadual anda sendiri adalah fallback selamat.
Adakah terdapat persekitaran sandbox?
Jawapan autoritatif ada dalam dokumentasi API semasa. Jika sandbox disenaraikan, gunakannya untuk ujian integrasi. Jika tiada disenaraikan, jangan cipta pesanan berbayar sebenar semasa ujian automatik tanpa kebenaran jelas — gunakan kempen ujian khusus dan semakan manusia sebaliknya.
Bolehkah pesanan API menggunakan Penerbitan Segera?
Ketersediaan Penerbitan Segera bergantung pada laman web yang dipilih mempunyai integrasi penerbitan automatik yang disokong (sama ada pemalam BlogDrip WordPress atau sambungan Agency API). Mana-mana pesanan — API atau manual — yang diletakkan pada laman web yang layak boleh mendapat manfaat daripada penerbitan automatik. Tidak setiap laman web dalam pasaran menyokongnya, jadi integrasi anda harus menganggap masa penerbitan bergantung pada setiap laman web, bukan seragam.
Apa perbezaan antara Advertiser API dan Agency API?
Advertiser API untuk pelanggan yang mahu mengautomasikan pesanan pos tetamu dari perisian mereka sendiri. Agency API untuk agensi luaran, platform pembinaan pautan, dan rangkaian penerbit yang mahu menyambungkan inventori mereka sendiri ke BlogDrip dan mengautomasikan pemenuhan yang disokong. Kedua-duanya berdiri sendiri — menggunakan satu tidak memerlukan yang lain.
Apa yang berlaku jika saya ulang cuba permintaan penciptaan pesanan yang gagal?
Jika anda tidak melihat respons pengesahan, anggap permintaan pertama mungkin berjaya di sisi pelayan. Jangan secara automatik ulang cuba penciptaan pesanan yang bukan idempoten. Tambah kunci deduplikasi sisi-server, atau pertanyakan untuk pesanan yang mungkin telah dicipta sebelum ulang cuba — mana yang disokong aliran kerja anda dengan bersih. Ulang cuba pada pesanan yang berjaya tetapi tidak dilihat akan menghasilkan caj berganda.
Sedia untuk mengautomasi pembinaan pautan anda?
Buka dokumentasi API, jana kredensial anda, dan mula membina. Pasaran berkembang selari dengan automasi anda — bukan sebaliknya.