Vodič za developere
Napravite alat za automatizaciju link buildinga uz BlogDrip API
Povežite svoj softver direktno sa BlogDrip-om i automatizujte naručivanje gostujućih postova. Kreirajte prilagođene SEO tokove rada, integrišite postojeće aplikacije i efikasnije upravljajte operacijama izgradnje linkova.
Zašto automatizovati
Zašto razviti alat za automatizaciju link buildinga
SEO agencije i interni marketinški timovi nailaze na isti operativni obrazac: ručno traženje prilika za objavljivanje, ponovo unošenje narudžbina za gostujuće postove, upravljanje više kampanja klijenata, prebacivanje informacija između internog softvera, praćenje napretka narudžbina i pokušaj skaliranja svega toga bez proporcionalnog povećanja broja zaposlenih.
API integracija skida ponavljajući mehanički posao sa tima i preusmerava ga kroz kod. Vaš postojeći softver — CRM, alat za upravljanje kampanjama ili prilagođeni kontrolni panel u kojem tim već radi — priča direktno sa tržištem. Operateri ostaju fokusirani na strategiju, briefove i kontrolu kvaliteta umesto na unos narudžbina.
Automatizacija donosi efikasnost tokova rada, ne SEO pozicije. Neće učiniti neuspešnu kampanju uspešnom i neće zameniti ljudsku procenu pri izboru izdavača. Ono što radi dobro jeste uklanjanje sloja unošenja podataka, tako da kada odlučite šta da kupite, možete to izvršiti u bilo kom obimu.
Šta možete napraviti
Šta možete izgraditi uz BlogDrip API
Praktični obrasci za softver zasnovan na programatskoj integraciji sa tržištem.
Prilagođeni panel za gostujuće postove
Interna aplikacija koja se povezuje sa BlogDrip i iz UI-ja kojim vaš tim upravlja podnosi podržane narudžbine gostujućih postova.
Sistem upravljanja za SEO agenciju
Naručivanje gostujućih postova integrisano u postojeći radni tok agencije, tako da menadžeri kampanja ne napuštaju sistem koji već koriste.
Automatizovano podnošenje narudžbina
API zahtevi kreiraju podržane narudžbine gostujućih postova u serijama, bez ručnog unošenja podataka za svaku narudžbinu.
Upravljanje kampanjama klijenata
Povežite interne evidencije klijenata i kampanja sa BlogDrip tokovima naručivanja — jedinstveni izvor istine o tome ko šta kupuje.
Automatizacija tokova rada
Pokrećite podržane API operacije iz internih poslovnih procesa — odobrenja, pokretanja, zakazani talasi kampanja.
Izveštavanje i nadzor
Preuzmite informacije vezane za narudžbine u prilagođene alate za izveštavanje gde je to podržano. Ograničite izveštavanje na ono što API zaista izlaže umesto da pretpostavljate potpunu real-time vidljivost.
Arhitektura
Primer arhitekture automatizacije
Zdrava integracija razdvaja odgovornosti kroz četiri sloja.
Na vrhu je vaša eksterno automatizaciona aplikacija — prilagođeni kontrolni panel, softver SEO agencije, interni CRM ili sistem za upravljanje kampanjama. Tu vaš tim radi svakodnevno.
Ispod toga stoji backend vaše aplikacije. Njegove odgovornosti su one koje svaka integracija mora ispravno da uradi: bezbedno čuvanje `x-client-id` i `x-client-secret`, validacija ulaza pre nego što stigne do BlogDrip-a, priprema i slanje API zahteva, obrada `{ data, pagination }` odgovora, logovanje operativnih događaja i bezbedno upravljanje retry pokušajima tako da privremeni mrežni problem ne preraste u duplu plaćenu narudžbinu.
Dalje, zahtevi stižu do BlogDrip Advertiser API-ja — javne, verzionisane površine pod `/api/public/*` — koja izlaže podržanu funkcionalnost naručivanja gostujućih postova.
API usmerava narudžbine u BlogDrip tržište — više od 275,000 sajtova ukupnog inventara — i odatle u odgovarajući proces obrade narudžbina i tok objavljivanja. U zavisnosti od izabranog sajta, objavljivanje može biti ručno na strani izdavača ili automatizovano preko WordPress plugina ili Agency API-ja. Ne podržava svaki sajt na tržištu Instant Publishing, zato vaša integracija treba da tretira vreme objave kao zavisno od toka rada, a ne kao trenutnu.
Izgradite svoj alat za automatizaciju, korak po korak
Osam koraka od planiranja do nadzora. Smatrate ih referencom, ne strogo određenim redosledom — mnogi od njih se mogu paralelno odvijati.
Odredite tok automatizacije
Identifikujte koje zadatke treba automatizovati, koje informacije vaša aplikacija treba, kada narudžbina treba da se podnese, kako se sprečavaju duplikati narudžbina, kako se rukuju greške i kako se čuvaju podaci o kampanjama. Konkretan primer obima: agencija koja upravlja 20 klijenata, svaki sa 3–5 aktivnih kampanja, želi da nove kampanje automatski generišu narudžbine za listu prethodno odobrenih sajtova — ali tek nakon što čovek odobri brief kampanje.
Dobijte pristup BlogDrip API-ju
Otvorite svoj nalog na app.blogdrip.com/settings i idite na Moja podešavanja → API pristup da pronađete svoje akreditive. Videćete dve vrednosti: `x-client-id` i `x-client-secret`. Secret se prikazuje jednom prilikom izdavanja ili rotacije, zato ga odmah kopirajte u svoj secret manager. Pristup zahteva minimalnu ukupnu potrošnju od €500 mesečno — ručne narudžbine i API narudžbine se računaju, oba kanala zajedno. API pristup se automatski deaktivira ako minimum nije ispunjen u datom mesecu. €500 je prag potrošnje, a ne odvojena pretplata za API.
Pročitajte API dokumentaciju
Zvanična dokumentacija na app.blogdrip.com/api/public/docs/index.html opisuje tačne endpoint-e pod `/api/public/*` namespace-om, autentifikaciju (dva header para pomenuta gore), metode zahteva, obavezne parametre, formate odgovora (list endpoint-i umotavaju odgovore u `{ data, pagination }` sa 0-based `?page=0`), validacione greške (`{ message }`) i dostupne operacije naručivanja. Smatrajte dokumentaciju autoritativnim izvorom: ako parametar nije dokumentovan, nemojte pretpostavljati da postoji.
Napravite API konekciju
Kreirajte backend aplikacije koji bezbedno čuva i `x-client-id` i `x-client-secret` (environment varijable, secret manager — nikada u frontend kodu), šalje autentifikovane zahteve sa oba header-a postavljena, parsira odgovore, rukuje greškama i piše strukturisane logove za svaki izlazni poziv. Držite API klijent kao mali, dobro testiran modul tako da ostatak aplikacije nikada direktno ne komunicira sa BlogDrip-om.
Implementirajte automatizovano naručivanje gostujućih postova
Povežite vaš interni tok rada sa podržanim BlogDrip operacijama naručivanja. Tipičan tok: kreira se nova kampanja u vašem sistemu → bira se sajt (rezolvirajte njegov `marketSiteId` preko marketplace endpoint-a) → vaša aplikacija priprema zahtevane informacije za narudžbinu (title, URL, description, `categoryId`, `marketSiteId`, `campaignId`, opciono `scheduleDate`, `linkNoFollow`) → backend validira narudžbinu prema vašim poslovnim pravilima → aplikacija podnosi narudžbinu preko Advertiser API-ja → odgovor se čuva u vašem sistemu radi traga. Validirajte svako polje prema OpenAPI spec pre slanja.
Rukujte greškama i duplikatima narudžbina
Validirajte zahteve pre slanja, sprečite slučajne duplikate narudžbina (idempotentni ključ ili serverska de-duplikacija na vašoj strani je bezbedan obrazac), logujte svaki API neuspeh sa dovoljno konteksta za kasniju dijagnostiku, elegantno rešavajte privremene probleme konekcije i poštujte dokumentovane rate limite. Jedno pravilo za internalizaciju: nikada automatski ne retry-ujte ne-idempotentni zahtev za kreiranje narudžbine bez eksplicitnog ljudskog ili sistemskog potvrđivanja — retry na uspešnoj narudžbini čiji odgovor niste primili stvara duplu naplatu.
Testirajte integraciju
Pokrenite integraciju protiv sandbox okruženja ako je dokumentovano. Ako sandbox nije dostupan, testirajte pažljivo u produkciji — nikada ne pokrećite automatske test suite-ove koji kreiraju stvarne plaćene narudžbine bez eksplicitnog odobrenja. Koristite posvećenu test kampanju sa ljudskim pregledom pre prve automatizovane narudžbine i ograničite automatizovane testove na kratku listu sajtova koje ste unapred odobrili za testiranje integracije.
Deploy i nadzor
Premestite akreditive u produkcioni secret store, dodajte nadzor za padove integracije i neobične obrasce podnošenja narudžbina, pratite rezultate podnošenja narudžbina end-to-end, čuvajte operativne logove dovoljno dugo da možete dijagnostikovati incident star dve nedelje, pratite potrošnju na računu da ne izgubite API pristup zbog pada ispod €500 mesečnog minimuma i pratite BlogDrip changelog za API izmene koje mogu zahtevati održavanje integracije.
Obrasci integracije
Kako izgleda zdrava integracija
Autoritativni izvor za izvršne primere je OpenAPI specifikacija na app.blogdrip.com/api/public/openapi.json i čitljiva dokumentacija na /api/public/docs. Specifikacija je ono prema čemu bi vaš kod trebalo da bude generisan ili proveravan — ne neki kratki primer sa landing stranice koji može zastareti.
U praksi, čista integracija obično prati isti oblik. Tanak API-klijent modul u jeziku po izboru — po jedna wrapper funkcija po operaciji koja vam treba — rukuje mehanikom: postavlja `x-client-id` i `x-client-secret` header-e za svaki zahtev, serijalizuje telo zahteva, deserijalizuje `{ data, pagination }` omotač na list endpoint-ima (paginacija počinje od 0) i konvertuje error odgovore (`{ message }`) u izuzetke koje vaša poslovna logika može čistо da uhvati. Svaki wrapper ima bar jedan test koji asertuje dokumentovani oblik, tako da promena šeme izađe kao neuspeli test pre nego što stigne u produkciju. Tek kad je taj modul stabilan, povežete ga sa ostatkom aplikacije — triggeri kampanja, redovi narudžbina, retry radnici, izveštavanje.
Ovaj redosled čini integraciju audibilnom: vaš API klijent je mali, dobro testiran površinski sloj; sve ostalo komunicira sa BlogDrip-om kroz njega.
Najbolje prakse
Šta održava API integraciju dugoročno
Obrasci koji održavaju automatizovane sisteme stabilnim dugo nakon lansiranja.
Idempotentnost po dizajnu
Tretirajte kreiranje narudžbina kao skupo i nepovratno. De-duplirajte na svojoj strani pre nego što zahtev ode — nikada posle.
Bezbedno upravljanje akreditivima
API akreditive čuvajte u secret manageru, po okruženju. Rotirajte ih prilikom odlaska zaposlenog, ne čekajte do incidenta.
Strukturisano logovanje
Svaki par zahtev + odgovor dobija ID za korelaciju. Buduće debugovanje stare narudžbine će zahvaliti na ovome.
Klijenti koji poštuju rate limite
Poštujte dokumentovane rate limite. Klijent koji se lepo povlači i skalira bolje od onog koji agresivno retry-uje.
Ljudski nadzor
Zaštitite prvi produkcioni poziv ljudskim odobrenjem. Širite automatizaciju tek nakon što integracija dokaže stabilnost.
Praćenje potrošnje
Obaveštavajte kada mesečna potrošnja računa ide prema ili ispod €500. Izgubiti API pristup usred kampanje je bolno.
Najčešća pitanja
Za koga je BlogDrip API namenjen?
Nalozi oglašivača koji žele da povežu sopstveni softver — prilagođeni kontrolni panel, platformu SEO agencije, interni CRM — sa BlogDrip-ovim procesom naručivanja gostujućih postova. Tipični korisnici su agencije koje upravljaju kampanjama u obimu, interni SEO timovi koji integrišu postojeći stack i developeri koji prave operativne alate za određenog klijenta ili proizvod.
Da li moram biti developer da bih koristio API?
Da biste izgradili samu integraciju — da. API je programski interfejs — njegovo korišćenje zahteva pisanje koda ili rad sa developerom. Ako želite operativne prednosti bez posla oko integracije, marketplace UI pokriva istu funkcionalnost naručivanja ručno.
Koji su zahtevi za pristup?
Aktivan BlogDrip nalog koji troši najmanje €500 mesečno u zbiru — ručne i API narudžbine se računaju prema pragu. API pristup se automatski deaktivira ako vaš nalog u datom mesecu potroši manje. €500 je prag volumena, a ne zasebna pretplata za API.
Gde je API dokumentacija?
Zvanična API dokumentacija je objavljena na app.blogdrip.com/api/public/docs/index.html, a mašinski čitljiva OpenAPI specifikacija je na app.blogdrip.com/api/public/openapi.json. Obe opisuju šemu autentifikacije, kompletan katalog endpoint-a pod `/api/public/*` namespace-om, oblike zahteva i odgovora, format paginacije i error odgovore. Smatrajte ih izvorom istine za vašu integraciju.
Gde nalazim svoje API akreditive?
U Moja podešavanja → API pristup na app.blogdrip.com/settings. Dobićete `x-client-id` i `x-client-secret`; oba idu u svaki autentifikovani zahtev kao HTTP header-i. Secret se prikazuje jednom kada je izdat ili rotiran — odmah ga kopirajte u svoj secret manager, jer ga kasnije ne možete povratiti. Akreditive tretirajte kao svaki drugi tajni podatak i držite ih van version controla.
Kako paginacija radi na list endpoint-ima?
List endpoint-i umotavaju svoje odgovore u `{ data, pagination }` omotač i koriste paginaciju koja počinje od 0 — prosledite `?page=0` za prvu stranu, `?page=1` za drugu, i tako dalje. Pagination blok u odgovoru govori da li postoje dodatne stranice. Ako migrirate sa legacy `/api/<path>` interfejsa, oblik odgovora je nepromenjen — menja se samo bazni put na `/api/public/*`.
Da li API podržava webhook-ove?
Proverite OpenAPI specifikaciju na app.blogdrip.com/api/public/openapi.json za trenutnu listu podržanih callback ili event-notification mehanizama. Ako funkcija nije navedena, gradite integraciju bez pretpostavke da postoji — polling API-ja po sopstvenom rasporedu je bezbedna alternativa.
Postoji li sandbox okruženje?
Autoritativan odgovor nalazi se u trenutnoj API dokumentaciji. Ako je sandbox naveden, koristite ga za testiranje integracije. Ako nije naveden, ne kreirajte stvarne plaćene narudžbine tokom automatizovanih testova bez eksplicitnog odobrenja — koristite posvećenu test kampanju i ljudski pregled umesto toga.
Mogu li API narudžbine koristiti Instant Publishing?
Dostupnost Instant Publishing zavisi od toga da li izabrani sajt ima podržanu automatizovanu integraciju za objavljivanje (bilo BlogDrip WordPress plugin ili Agency API konekcija). Bilo koja narudžbina — API ili ručna — postavljena na podržanom sajtu može imati koristi od automatskog objavljivanja. Ne podržava svaki sajt na tržištu tu opciju, zato vaša integracija treba da tretira vreme objave kao svojstveno za svaki sajt, a ne kao uniformno.
Po čemu se razlikuju Advertiser API i Agency API?
Advertiser API je za kupce koji žele da automatizuju naručivanje gostujućih postova iz svog softvera. Agency API je za spoljne agencije, platforme za izgradnju linkova i mreže izdavača koje žele da povežu svoj inventar sa BlogDrip-om i automatizuju podrženo fulfilment. Oba su samostalna — korišćenje jednog ne zahteva drugi.
Šta se dešava ako retry-ujem neuspeo zahtev za kreiranje narudžbine?
Ako niste videli potvrđeni odgovor, pretpostavite da je prvi zahtev možda uspeo na serverskoj strani. Ne retry-ujte automatski ne-idempotentno kreiranje narudžbine. Dodajte serverski de-duplikacioni ključ ili query-ujte moguće kreiranu narudžbinu pre ponovnog pokušaja — šta god vaš tok rada podržava čisto. Retry na uspešnoj, ali nevidljivoj narudžbini stvara duplu naplatu.
Spremni za automatizaciju link buildinga?
Otvorite API dokumentaciju, generišite akreditive i počnite da gradite. Tržište se prilagođava vašoj automatizaciji — ne obrnuto.