Geliştirici kılavuzu
BlogDrip API ile kendi bağlantı oluşturma otomasyon aracınızı oluşturun
Yazılımınızı doğrudan BlogDrip'e bağlayın ve konuk gönderi siparişlerini otomatikleştirin. Özel SEO iş akışları oluşturun, mevcut uygulamalarınızı entegre edin ve bağlantı oluşturma operasyonlarını daha verimli yönetin.
Neden otomasyon
Neden kendi bağlantı oluşturma otomasyon aracınızı kurmalısınız
SEO ajansları ve kurum içi pazarlama ekipleri aynı operasyonel desenle karşılaşıyor: yayın fırsatlarını elle aramak, konuk gönderi siparişlerini tekrar girmek, birden çok müşteri kampanyasını yönetmek, dahili sistemler arasında bilgi aktarmak, sipariş ilerlemesini izlemek ve tüm bunları personel sayısını aynı oranda artırmadan ölçeklendirmeye çalışmak.
Bir API entegrasyonu, tekrar eden mekanik işleri ekibinizin omzundan alır ve bunları kod üzerinden yönlendirir. Mevcut yazılımınız — CRM, kampanya yönetim aracı veya ekibinizin günlük kullandığı özel kontrol paneli — doğrudan pazar yerine konuşur. Operasyon ekipleri, sipariş girişi yerine strateji, brifingler ve kalite kontrola odaklanır.
Otomasyon, iş akışı verimliliği sağlar; SEO sıralamalarını otomatik olarak iyileştirmez. Kötü bir kampanyayı başarılı yapmaz ve yayıncı seçimi konusunda insan yargısının yerini almaz. İyi yaptığı şey, veri girişi katmanını ortadan kaldırmaktır; böylece ne satın alacağınıza karar verdiğinizde bunu herhangi bir hacimde uygulayabilirsiniz.
Neler oluşturabilirsiniz
BlogDrip API ile neler oluşturabilirsiniz
Programatik pazar yeri entegrasyonunun üzerine kurulan yazılımlar için pratik desenler.
Özel konuk gönderi kontrol paneli
BlogDrip'e bağlanan ve ekibinizin kontrol ettiği bir arayüzden desteklenen konuk gönderi siparişlerini gönderen dahili bir uygulama.
SEO ajansı yönetim sistemi
Konuk gönderi siparişlerinin mevcut ajans iş akışınıza bağlanması; kampanya yöneticileri zaten kullandıkları sistemi terk etmez.
Otomatik sipariş gönderimi
API istekleri, sipariş başına manuel veri girişi adımı olmadan toplu şekilde desteklenen konuk gönderi siparişleri oluşturur.
Müşteri kampanya yönetimi
Dahili müşteri ve kampanya kayıtlarını BlogDrip sipariş iş akışlarına bağlayın — kimin ne satın aldığı için tek doğruluk kaynağı.
İş akışı otomasyonu
Onaylar, başlatmalar, planlı kampanya dalgaları gibi dahili iş süreçlerinden desteklenen API işlemlerini tetikleyin.
Raporlama ve izleme
Desteklenen durumlarda siparişe ilişkin bilgileri özel raporlama araçlarına çekin. Raporlamayı API'nin gerçekten açığa çıkardığıyla sınırlayın; tam gerçek zamanlı görünürlük varsaymayın.
Mimari
Örnek otomasyon mimarisi
Sağlıklı bir entegrasyon, sorumlulukları dört katmana ayırır.
En üstte, harici otomasyon uygulamanız — özel bir kontrol paneli, bir SEO ajansı yazılımı, dahili CRM veya kampanya yönetim sistemi. Ekibinizin günlük çalıştığı yer burasıdır.
Bunun altında uygulama backend'iniz bulunur. Sorumlulukları her entegrasyonun doğru yapması gerekenlerdir: `x-client-id` ve `x-client-secret` değerlerini güvenli şekilde saklamak, girdiyi BlogDrip'e ulaşmadan önce doğrulamak, API isteklerini hazırlayıp göndermek, `{ data, pagination }` yanıtlarını işlemek, operasyonel olayları kaydetmek ve geçici ağ kesintisinin ücretli bir siparişin tekrarlanmasına dönüşmemesi için yeniden denemeleri güvenli şekilde yönetmek.
Bundan sonra istekler BlogDrip Advertiser API'ye ulaşır — `/api/public/*` altında halka açık, sürümlü yüzey — ve desteklenen konuk gönderi siparişi işlevselliğini açığa çıkarır.
API, siparişleri BlogDrip pazar yerine yönlendirir — toplam envanterde 275,000+ web sitesi — ve oradan ilgili sipariş işleme ve yayın akışına aktarır. Seçilen web sitesine bağlı olarak yayınlama, yayıncının tarafında manuel olabilir veya WordPress eklentisi ya da Agency API üzerinden otomatik olabilir. Pazar yerindeki her site Instant Publishing'i desteklemeyebilir; bu yüzden entegrasyonunuz yayınlama zamanlamasını anlık değil, iş akışına bağlı olarak ele almalıdır.
Otomasyon aracınızı adım adım oluşturun
Kapsam belirlemeden izlemeye kadar sekiz adım. Bunları sabit bir sıradan ziyade bir referans olarak değerlendirin — birçoğu paralel çalışır.
Otomasyon iş akışınızı tanımlayın
Hangi görevlerin otomatikleştirileceğini, uygulamanızın hangi bilgilere ihtiyaç duyacağını, bir siparişin ne zaman gönderileceğini, yinelenen siparişlerin nasıl önleneceğini, hataların nasıl ele alınacağını ve kampanya verilerinin nasıl saklanacağını belirleyin. Somut bir kapsam örneği: 20 müşteriyi yöneten, her biri 3–5 aktif kampanyaya sahip bir ajans; yeni kampanyaların, insan onayı alındıktan sonra önceden onaylanmış web sitelerden oluşan bir kısa liste için otomatik olarak sipariş oluşturmasını istiyor.
BlogDrip API erişimi edinin
Hesabınızı app.blogdrip.com/settings adresinde açın ve Kimlik Bilgilerim → API access bölümüne giderek kimlik bilgilerinizi bulun. İki değer göreceksiniz: bir `x-client-id` ve bir `x-client-secret`. Gizli değer verildiğinde veya döndürüldüğünde bir kez gösterilir; bu yüzden hemen gizli yöneticinize kopyalayın. Erişim için hesap bazında toplam aylık harcamanın en az €500 olması gerekir — manuel siparişler sayılır, API siparişleri sayılır; her ikisi birlikte hesaplanır. Minimum tutar karşılanmazsa API erişimi otomatik olarak devre dışı bırakılır. €500 bir harcama eşiğidir, ayrı bir API abonelik ücreti değildir.
API belgelerini okuyun
Resmi dokümanlar app.blogdrip.com/api/public/docs/index.html adresinde `/api/public/*` ad alanı altındaki tam uç noktaları, kimlik doğrulamayı (yukarıda bahsedilen iki başlık çiftini), istek yöntemlerini, gerekli parametreleri, yanıt formatlarını (liste uç noktaları yanıtları `{ data, pagination }` paketinde döndürür ve 0 tabanlı `?page=0` kullanılır), doğrulama hatalarını (`{ message }`) ve kullanılabilir sipariş işlemlerini açıklar. Dokümantasyonu yetkili kaynak olarak kabul edin: bir parametre belgelenmemişse, var olduğunu varsaymayın.
API bağlantısını kurun
Hem `x-client-id` hem de `x-client-secret` değerlerini güvenli şekilde saklayan (ortam değişkenleri, gizli yönetici — asla frontend kodunda değil) bir uygulama backend'i oluşturun, her iki başlık ayarlı olarak yetkilendirilmiş istekler gönderin, yanıtları ayrıştırın, hataları yönetin ve her çıkan çağrı için yapılandırılmış günlükler yazın. API istemcisini küçük, iyi test edilmiş bir modül olarak tutun, böylece uygulamanızın geri kalanı doğrudan BlogDrip ile konuşmaz.
Otomatik konuk gönderi siparişi uygulayın
Dahili iş akışınızı desteklenen BlogDrip sipariş işlemlerine bağlayın. Tipik bir akış: sisteminizde yeni bir kampanya oluşturulur → bir web sitesi seçilir (pazar yeri uç noktalarından `marketSiteId` değerini çözümleyin) → uygulamanız gerekli sipariş bilgilerini hazırlar (başlık, URL, açıklama, `categoryId`, `marketSiteId`, `campaignId`, isteğe bağlı `scheduleDate`, `linkNoFollow`) → backend iş kurallarınıza karşı siparişi doğrular → uygulama Advertiser API üzerinden siparişi gönderir → yanıt izlenebilirlik için sisteminizde saklanır. Gönderimden önce her alanı OpenAPI spesifikasyonuna göre doğrulayın.
Hataları ve yinelenen siparişleri yönetin
Gönderimden önce istekleri doğrulayın, kazara yinelenen siparişleri önleyin (idempotency anahtarı veya sunucu tarafı deduplikasyon kontrolü güvenli bir desendir), her API hatasını ileride hata ayıklama yapacak kadar bağlamla kaydedin, geçici bağlantı problemlerini zarifçe yönetin ve belgelenmiş hız sınırlarına uyun. İçselleştirilecek bir kural: yanıtını görmediğiniz başarılı bir sipariş için insan veya sistem onayı olmadan idempotent olmayan bir sipariş oluşturma isteğini otomatik tekrar denemeyin — görmediğiniz bir yanıt üzerine yapılan tekrar çift ücretlendirmeye yol açar.
Entegrasyonunuzu test edin
Eğer belgelenmiş bir sandbox ortamı varsa entegrasyonunuzu onun üzerinde çalıştırın. Sandbox yoksa üretim üzerinde dikkatli test edin — açıkça yetkilendirilmiş olmadan gerçek ücretli siparişler oluşturan otomatik test paketlerini asla çalıştırmayın. İlk otomatik sipariş gönderilmeden önce insan denetimli bir incelemeye sahip ayrılmış bir test kampanyası kullanın ve otomatik test çalıştırmalarını entegrasyon testi için önceden onayladığınız kısa bir web sitesi izin listesinden kısıtlayın.
Dağıtım ve izleme
Kimlik bilgilerini üretim gizli deposuna taşıyın, entegrasyon hataları ve alışılmadık sipariş gönderim desenleri için izleme ekleyin, sipariş gönderim sonuçlarını uçtan uca izleyin, iki haftalık bir olayı hata ayıklamak için yeterli süreyle operasyonel günlükleri saklayın, hesabınızın harcamasını izleyin ki aylık €500 minimumun altına düşüp API erişimini kaybetmeyesiniz ve entegrasyon bakımına gerek duyabilecek API güncellemeleri için BlogDrip değişiklik günlüğünü takip edin.
Entegrasyon desenleri
Sağlıklı bir entegrasyon nasıl görünür
Çalıştırılabilir örnekler için yetkili kaynak, app.blogdrip.com/api/public/openapi.json adresindeki OpenAPI spesifikasyonu ve insan tarafından okunabilir dokümanlar olan /api/public/docs'tur. Spesifikasyona göre kodunuzun üretilmesi veya doğrulanması gerekir — açılış sayfası parçacığına güvenmeyin.
Pratikte temiz bir entegrasyon aynı şekli takip eder. Tercih ettiğiniz dilde ince bir API-istemci modülü — ihtiyaç duyduğunuz her işlem için bir sarmalayıcı fonksiyon — mekanikleri halleder: her istekte `x-client-id` ve `x-client-secret` başlıklarını ayarlar, istek gövdesini serileştirir, liste uç noktalarında `{ data, pagination }` paketini (0 tabanlı sayfalama) ayrıştırır ve hata yanıtlarını (`{ message }`) iş mantığınızın kolayca yakalayabileceği istisnalara çevirir. Her sarmalayıcı en az bir test ile belgelenmiş şekli doğrular, böylece bir şema değişikliği üretime ulaşmadan önce testin bozulmasıyla görünür olur. Bu modül stabil olduktan sonra kampanya tetikleyicileri, sipariş kuyrukları, yeniden deneme işçileri ve raporlama gibi uygulamanızın geri kalanıyla bağlanır.
Bu sıra, entegrasyonun denetlenebilir kalmasını sağlar: API istemciniz küçük, iyi test edilmiş bir yüzey alanıdır; gerisi onun üzerinden BlogDrip ile konuşur.
En iyi uygulamalar
Bir API entegrasyonunun uzun ömürlü olmasını sağlayanlar
Lansman gününden çok sonra otomatik sistemleri sağlıklı tutan desenler.
İdempotentlik tasarımı
Sipariş oluşturmayı maliyetli ve geri döndürülemez olarak ele alın. İstek dışına çıkmadan önce kendi tarafınızda deduplikasyon yapın — asla sonra değil.
Kimlik bilgisi hijyeni
API kimlik bilgileri bir gizli yöneticide, ortam başına ayrılmış şekilde tutulmalıdır. Ayrılma durumunda döndürün; ihlal üzerine değil.
Yapılandırılmış günlükleme
Her istek + yanıt çifti bir korelasyon kimliği alır. Geç kalmış bir siparişi hata ayıklayan gelecekteki siz, şimdiki sizden memnun olacak.
Hız sınırlarına duyarlı istemciler
Belgelenmiş hız sınırlarına uyun. Nazikçe geri çekilen bir istemci, agresif tekrar deneyen birinden daha iyi ölçeklenir.
Süreçte insan
İlk üretim çağrısını insan onayının arkasına alın. Entegrasyon kararlı olduğunu kanıtladıktan sonra otomasyonu genişletin.
Harcama izleme
Aylık hesap harcaması €500 eşiğine doğru veya altına düşme eğiliminde olduğunda uyarı oluşturun. Bir kampanya ortasında API erişimini kaybetmek can sıkıcıdır.
Sıkça sorulan sorular
BlogDrip API kimler için?
Kendi yazılımlarını — özel bir kontrol paneli, bir SEO ajansı platformu, dahili CRM — BlogDrip'in konuk gönderi sipariş iş akışına bağlamak isteyen Advertiser hesapları için. Tipik kullanıcılar yüksek hacimde kampanya yöneten ajanslar, mevcut yığına entegrasyon yapan kurum içi SEO ekipleri ve belirli bir müşteri veya ürün için operasyonel araçlar geliştiren geliştiricilerdir.
API'yi kullanmak için geliştirici olmam gerekiyor mu?
Entegrasyonu kendiniz kurmak istiyorsanız evet. API programatik bir arayüzdür — kullanmak kod yazmayı veya bir geliştirici ile çalışmayı gerektirir. Entegrasyon çalışması olmadan operasyonel faydaları istiyorsanız, pazar yeri kullanıcı arayüzü aynı sipariş işlevselliğini manuel olarak sağlar.
Erişim gereksinimleri nelerdir?
Toplamda aylık en az €500 harcama yapan aktif bir BlogDrip hesabı — manuel ve API siparişleri eşik için sayılır. Hesabınız bir ay içinde bu tutarın altına düşerse API erişimi otomatik olarak devre dışı bırakılır. €500 bir hacim eşiğidir, ayrı bir API abonelik ücreti değildir.
API belgeleri nerede?
Resmi API belgeleri app.blogdrip.com/api/public/docs/index.html adresinde yayımlanmıştır; makine okunur OpenAPI spesifikasyonu app.blogdrip.com/api/public/openapi.json adresindedir. Her ikisi de kimlik doğrulama şemasını, `/api/public/*` ad alanı altındaki tam uç nokta kataloğunu, istek ve yanıt şekillerini, sayfalama formatını ve hata yanıtlarını açıklar. Entegrasyonunuz için bunları yetkili kaynak olarak kabul edin.
API kimlik bilgilerini nerede bulurum?
app.blogdrip.com/settings içindeki My Settings → API access bölümünde. Bir `x-client-id` ve bir `x-client-secret` alacaksınız; her ikisi de yetkilendirilmiş her isteğe HTTP başlıkları olarak gider. Gizli değer verildiğinde veya döndürüldüğünde yalnızca bir kez gösterilir — daha sonra alınamaz; hemen gizli yöneticinize kopyalayın. Kimlik bilgileri hesap başına verilir; diğer gizli bilgiler gibi ele alın ve sürüm kontrolüne koymayın.
Liste uç noktalarında sayfalama nasıl çalışır?
Liste uç noktaları yanıtlarını `{ data, pagination }` paketinde döndürür ve 0 tabanlı sayfalama kullanır — ilk sayfa için `?page=0`, ikinci için `?page=1` geçirin. Yanıttaki pagination bloğu daha fazla sayfa olup olmadığını söyler. Eski `/api/<path>` arayüzünden geçiş yapıyorsanız, yanıt şekli değişmez — yalnızca temel yol `/api/public/*` olarak taşınır.
API webhooks destekliyor mu?
Desteklenen geri çağırma veya olay-bildirim mekanizmalarının mevcut listesini app.blogdrip.com/api/public/openapi.json adresindeki OpenAPI spesifikasyonunda kontrol edin. Bir özellik listelenmemişse, entegrasyonunuzu bunun var olduğunu varsaymadan kurun — kendi programınıza göre API'yi düzenli aralıklarla sorgulamak güvenli bir geri dönüş yoludur.
Bir sandbox ortamı var mı?
Yetkili cevap mevcut API dokümantasyonunda yer alır. Eğer bir sandbox listelenmişse, entegrasyon testi için onu kullanın. Listelenmemişse, açıkça yetkilendirilmiş olmadan otomatik testler sırasında gerçek ücretli siparişler oluşturmayın — bunun yerine ayrılmış bir test kampanyası ve insan denetimli inceleme kullanın.
API siparişleri Instant Publishing'i kullanabilir mi?
Instant Publishing erişilebilirliği, seçilen web sitesinin desteklenen otomatik yayın entegrasyonuna (BlogDrip WordPress eklentisi veya bir Agency API bağlantısı) sahip olup olmadığına bağlıdır. Uygun bir web sitesine verilen herhangi bir sipariş — API veya manuel — otomatik yayınlamadan yararlanabilir. Pazar yerindeki her site bunu desteklemez; entegrasyonunuz yayınlama zamanlamasını site bazlı olarak ele almalıdır.
Advertiser API ile Agency API arasındaki fark nedir?
Advertiser API, kendi yazılımlarından konuk gönderi siparişlerini otomatikleştirmek isteyen müşteriler içindir. Agency API ise kendi envanterini BlogDrip'e bağlamak ve desteklenen siparişlerin yerine getirilmesini otomatikleştirmek isteyen dış ajanslar, bağlantı oluşturma platformları ve yayıncı ağları içindir. Her ikisi de bağımsızdır — birini kullanmak diğerini gerektirmez.
Başarısız bir sipariş oluşturma isteğini tekrar denerseniz ne olur?
Onaylanmış bir yanıt görmediyseniz, ilk isteğin sunucu tarafında başarılı olmuş olabileceğini varsayın. İdempotent olmayan sipariş oluşturmayı otomatik olarak tekrar denemeyin. Sunucu tarafı deduplikasyon anahtarı ekleyin veya tekrar denemeden önce muhtemel oluşturulmuş siparişi sorgulayın — iş akışınızın temizce desteklediği yöntem hangisiyse onu kullanın. Görülmemiş ancak başarılı bir siparişe yapılan tekrar çift ücretlendirmeye yol açar.
Bağlantı oluşturmanızı otomatikleştirmeye hazır mısınız?
API belgelerini açın, kimlik bilgilerinizi oluşturun ve inşa etmeye başlayın. Pazar yeri otomasyonunuzla ölçeklenir — tersine değil.