Vodič za developere
Izradite vlastiti alat za automatizaciju link buildinga s BlogDrip API-jem
Povežite svoj softver izravno s BlogDripom i automatizirajte naručivanje gostujućih članaka. Izradite prilagođene SEO tijekove rada, integrirajte postojeće aplikacije i učinkovitije upravljajte operacijama link buildinga.
Zašto automatizirati
Zašto izraditi vlastiti alat za automatizaciju link buildinga
SEO agencije i interni marketinški timovi nailaze na isti operativni obrazac: ručno traženje prilika za objavu, ručno unošenje narudžbi gostujućih članaka, balansiranje više kampanja klijenata, prijenos informacija između internih sustava, praćenje napretka narudžbi i pokušaji skaliranja svega toga bez proporcionalnog povećanja broja zaposlenika.
Integracija preko API-ja uklanja repetitivni mehanički posao s radne ploče vašeg tima i preusmjerava ga kroz kod. Vaš postojeći softver — CRM, alat za upravljanje kampanjama ili prilagođeno sučelje u kojem tim radi — govori izravno s marketplaceom. Operateri ostaju fokusirani na strategiju, briefove i kontrolu kvalitete umjesto na unos narudžbi.
Automatizacija donosi učinkovitost tijekova rada, a ne SEO pozicije. Ne može natjerati lošu kampanju da uspije i ne zamjenjuje ljudsku prosudbu pri odabiru izdavača. Ono što radi dobro je uklanjanje sloja unosa podataka, pa kad odlučite što kupiti možete to izvršavati u bilo kojoj količini.
Što možete izgraditi
Što možete izgraditi s BlogDrip API-jem
Praktični obrasci za softver izgrađen na programatskoj integraciji s marketplaceom.
Prilagođeno sučelje za gostujuće članke
Interna aplikacija koja se povezuje s BlogDripom i iz sučelja kojim upravlja vaš tim podnosi podržane narudžbe gostujućih članaka.
Sustav upravljanja za SEO agencije
Naručivanje gostujućih članaka integrirano u postojeći agencijski tijek rada, tako da voditelji kampanja ne napuštaju sustav koji već koriste.
Automatsko slanje narudžbi
API pozivi stvaraju podržane narudžbe gostujućih članaka u serijama, bez ručnog unosa podataka za svaku narudžbu.
Upravljanje kampanjama klijenata
Povežite interne zapise o klijentima i kampanjama s BlogDrip tijekovima naručivanja — jedan izvor istine tko kupuje što.
Automatizacija tijekova rada
Pokrenite podržane API operacije iz internih poslovnih procesa — odobrenja, početci, zakazani valovi kampanja.
Izvještavanje i nadzor
Povucite informacije vezane uz narudžbe u prilagođene alate za izvještavanje kad je podržano. Ograničite izvještavanje na ono što API zapravo izlaže umjesto da pretpostavljate potpunu real-time vidljivost.
Arhitektura
Primjer arhitekture automatizacije
Zdrava integracija razdvaja odgovornosti preko četiri sloja.
Na vrhu je vaša vanjska automatizacijska aplikacija — prilagođeni dashboard, softver SEO agencije, interni CRM ili sustav za upravljanje kampanjama. Tu vaš tim radi iz dana u dan.
Ispod toga leži backend vaše aplikacije. Njegove odgovornosti su one koje svaka integracija mora pravilno riješiti: sigurno pohraniti `x-client-id` i `x-client-secret`, validirati ulaz prije nego što uopće dođe do BlogDripa, pripremiti i poslati API zahtjeve, obrađivati `{ data, pagination }` odgovore, logirati operativne događaje i sigurno upravljati ponovnim pokušajima kako bi privremeni mrežni prekid ne pretvorio u dupliciranu plaćenu narudžbu.
Od tamo zahtjevi dolaze do BlogDrip Advertiser API-ja — javne, verzionirane površine pod `/api/public/*` — koja izlaže podržanu funkcionalnost naručivanja gostujućih članaka.
API usmjerava narudžbe u BlogDrip marketplace — više od 275,000 web-stranica ukupnog inventara — a od tamo u odgovarajuće tijekove obrade narudžbi i objave. Ovisno o odabranoj web-stranici, objava može biti manualna na strani izdavača ili automatizirana kroz WordPress plugin ili Agency API. Ne podržava svaka web-stranica u marketplaceu Instant Publishing, stoga bi vaša integracija trebala tretirati vrijeme objave kao ovisno o tijeku rada, a ne trenutnim.
Izradite svoj alat za automatizaciju, korak po korak
Osam koraka od definiranja opsega do nadzora. Smatrajte ih referencom, a ne strogo određenim redoslijedom — mnogi se izvode paralelno.
Definirajte svoj tijek automatizacije
Odredite koje zadatke treba automatizirati, koje informacije vaša aplikacija treba, kada bi narudžba trebala biti poslana, kako spriječiti duplicirane narudžbe, kako se rješavaju pogreške i kako se podaci kampanje pohranjuju. Konkretan primjer opsega: agencija koja upravlja 20 klijenata, svaki s 3–5 aktivnih kampanja, želi da nove kampanje automatski generiraju narudžbe za kratku listu prethodno odobljenih web-stranica — ali tek nakon što čovjek odobri brief kampanje.
Nabavite pristup BlogDrip API-ju
Otvorite svoj račun na app.blogdrip.com/settings i idite na Moje postavke → API pristup da pronađete svoje vjerodajnice. Vidjet ćete dvije vrijednosti: `x-client-id` i `x-client-secret`. Secret se prikazuje jednom kad je izdan ili rotiran, pa ga odmah kopirajte u svoj secret manager. Pristup zahtijeva minimalno €500 mjesečno ukupne potrošnje računa — ručne narudžbe i API narudžbe računaju se zajedno. API pristup se automatski deaktivira ako minimum nije zadovoljen u određenom mjesecu. €500 je prag potrošnje, a ne zasebna pretplata za API.
Pročitajte API dokumentaciju
Službena dokumentacija na app.blogdrip.com/api/public/docs/index.html opisuje točne endpointe pod `/api/public/*` namespaceom, autentifikaciju (dva para headera spomenuta gore), metode zahtjeva, obavezne parametre, formate odgovora (list endpointi omotavaju odgovore u `{ data, pagination }` s 0-based `?page=0`), greške validacije (`{ message }`) i dostupne operacije naručivanja. Smatrajte dokumentaciju autoritativnim izvorom: ako parametar nije dokumentiran, nemojte pretpostavljati da postoji.
Izgradite API vezu
Napravite backend aplikacije koji sigurno čuva i `x-client-id` i `x-client-secret` (environment varijable, secret manager — nikad u frontend kodu), šalje autorizirane zahtjeve s oba headera postavljena, parsira odgovore, obrađuje pogreške i zapisuje strukturirane logove za svaki odlazni poziv. Držite API klijent kao mali, dobro testiran modul tako da ostatak aplikacije nikad ne komunicira s BlogDripom izravno.
Implementirajte automatizirano naručivanje gostujućih članaka
Povežite svoj interni tijek rada s podržanim BlogDrip operacijama naručivanja. Tipičan tok: u vašem sustavu se kreira nova kampanja → odabire se web-stranica (riješite njen `marketSiteId` iz marketplace endpointa) → vaša aplikacija priprema potrebne informacije za narudžbu (naslov, URL, opis, `categoryId`, `marketSiteId`, `campaignId`, opcionalno `scheduleDate`, `linkNoFollow`) → backend validira narudžbu prema vašim poslovnim pravilima → aplikacija pošalje narudžbu preko Advertiser API-ja → odgovor se pohranjuje u vaš sustav radi traga. Validirajte svako polje prema OpenAPI spec prije slanja.
Riješite pogreške i duplicirane narudžbe
Validirajte zahtjeve prije slanja, spriječite slučajne duplicirane narudžbe (idempotency key ili server-side de-duplication provjera na vašoj strani je siguran obrazac), logirajte svaki API neuspjeh s dovoljno konteksta za kasnije debugiranje, lijepo se nosite s privremenim problemima povezivosti i poštujte dokumentirane rate limite. Jedno pravilo za internalizirati: nikad automatski ne ponavljajte ne-idempotentan zahtjev za kreiranje narudžbe bez izričitog ljudskog ili sustavskog potvrđivanja — retry na uspješnu narudžbu čiji odgovor niste vidjeli stvara dvostruku naplatu.
Testirajte svoju integraciju
Pokrenite integraciju protiv sandbox okruženja ako je dokumentirano. Ako sandbox nije dostupan, testirajte pažljivo protiv produkcije — nikad ne pokrećite automatizirane testove koji stvaraju prave plaćene narudžbe bez izričitog odobrenja. Koristite namjensku testnu kampanju s ljudskim pregledom prije prve automatske narudžbe i ograničite automatizirane testove na kratku listu web-stranica koje ste prethodno odobrili za integracijsko testiranje.
Deployajte i nadgledajte
Premjestite vjerodajnice u svoj produkcijski secret store, dodajte nadzor za neuspjehe integracije i neuobičajene obrasce slanja narudžbi, pratite rezultate slanja narudžbi end-to-end, čuvajte operativne logove dovoljno dugo da debugirate incident star dva tjedna, nadgledajte potrošnju računa kako ne biste izgubili API pristup spuštanjem ispod €500 mjesečnog minimuma i pratite BlogDrip changelog za API nadogradnje koje mogu zahtijevati održavanje integracije.
Integracijski obrasci
Kako izgleda zdrava integracija
Autoritativni izvor za izvršne primjere je OpenAPI specifikacija na app.blogdrip.com/api/public/openapi.json i ljudski čitljiva dokumentacija na /api/public/docs. Specifikacija je ono prema čemu bi vaš kod trebao biti generiran ili provjeravan — ne copy-paste isječak s landing stranice koji može zastarjeti.
U praksi čista integracija obično slijedi isti oblik. Tanak API-klijent modul u vašem preferiranom jeziku — jedna wrapper funkcija po operaciji koja vam treba — rješava mehaniku: postavlja `x-client-id` i `x-client-secret` header-e na svaki zahtjev, serijalizira tijelo zahtjeva, deserializira `{ data, pagination }` omot na list endpointima (0-based paging) i pretvara error odgovore (`{ message }`) u iznimke koje vaša poslovna logika može uredno uhvatiti. Svaki wrapper ima barem jedan test koji provjerava dokumentirani oblik, tako da promjena sheme iskače kao neuspjeli test prije nego stigne u produkciju. Tek kad je taj modul stabilan, povežete ga s ostatkom aplikacije — triggerima kampanja, redovima narudžbi, retry workerima, izvještavanjem.
Taj slijed čini integraciju auditable: vaš API klijent je mala, dobro testirana površina; sve ostalo komunicira s BlogDripom kroz njega.
Dobre prakse
Što održava API integraciju dugotrajnom
Obrasci koji održavaju automatizirane sustave stabilnima dugo nakon dana lansiranja.
Idempotencija po dizajnu
Smatrajte kreiranje narudžbi skupim i nepovratnim. Uklonite duplikate na svojoj strani prije nego zahtjev ode — nikad nakon.
Higijena vjerodajnica
API vjerodajnice čuvajte u secret manageru, razdijeljene po okruženju. Rotirajte ih pri odlasku zaposlenika, a ne tek nakon proboja.
Strukturirano logiranje
Svaki par zahtjev + odgovor dobiva correlation ID. Kasniji Vi bit će zahvalni sadašnjem Vi-u.
Klijenti koji poštuju rate limite
Poštujte dokumentirane rate limite. Klijent koji uredno smanjuje broj pokušaja skalira bolje od agresivnog koji stalno retry-a.
Ljudski nadzor
Zaštitite prvi produkcijski poziv ljudskim odobrenjem. Automatizaciju širite tek nakon što integracija dokaže stabilnost.
Praćenje potrošnje
Upozorite kad mjesečna potrošnja računa krene prema ili padne ispod €500. Gubitak API pristupa usred kampanje je bolan.
Često postavljana pitanja
Za koga je BlogDrip API?
Računi oglašivača koji žele povezati vlastiti softver — prilagođeni dashboard, platformu SEO agencije, interni CRM — s BlogDripovim tijekovima naručivanja gostujućih članaka. Tipični korisnici su agencije koje upravljaju kampanjama u volumenu, interni SEO timovi koji integriraju s postojećim stackom i developeri koji grade operativne alate za određenog klijenta ili proizvod.
Trebam li biti developer da koristim API?
Za izgradnju same integracije — da. API je programatsko sučelje — njegovo korištenje zahtijeva pisanje koda ili suradnju s developerom. Ako želite operativne prednosti bez posla integracije, marketplace UI pokriva istu funkcionalnost naručivanja manualno.
Koji su uvjeti pristupa?
Aktivan BlogDrip račun koji mjesečno troši najmanje €500 u ukupnoj potrošnji — ručne i API narudžbe računaju se zajedno prema pragu. API pristup se automatski deaktivira ako vaš račun potroši manje u određenom mjesecu. €500 je prag volumena, a ne zasebna pretplata za API.
Gdje je API dokumentacija?
Službena API dokumentacija objavljena je na app.blogdrip.com/api/public/docs/index.html, sa strojno čitljivom OpenAPI specifikacijom na app.blogdrip.com/api/public/openapi.json. Oba izvora opisuju shemu autentifikacije, kompletan katalog endpointa pod `/api/public/*` namespaceom, oblike zahtjeva i odgovora, format paginacije i greške. Smatrajte ih izvorom istine za svoju integraciju.
Gdje nalazim svoje API vjerodajnice?
U Moje postavke → API pristup na app.blogdrip.com/settings. Dobit ćete `x-client-id` i `x-client-secret`; oba idu u svaki autorizirani zahtjev kao HTTP headeri. Secret se prikazuje jednom kad je izdan ili rotiran — odmah ga kopirajte u svoj secret manager, jer ga kasnije nije moguće dohvatiti. Vjerodajnice su po računu; tretirajte ih kao svaku drugu tajnu i držite ih izvan verzionog koda.
Kako radi paginacija na list endpointima?
List endpointi omotavaju svoje odgovore u `{ data, pagination }` envelope i koriste 0-based paging — proslijedite `?page=0` za prvu stranicu, `?page=1` za drugu, itd. Pagination blok u odgovoru govori postoji li još stranica. Ako migrirate s legacy `/api/<path>` sučelja, oblik odgovora ostaje nepromijenjen — samo se baza puta premješta na `/api/public/*`.
Podržava li API webhooks?
Provjerite OpenAPI spec na app.blogdrip.com/api/public/openapi.json za trenutni popis podržanih mehanizama za callback ili event-notifikacije. Ako značajka nije navedena, gradite integraciju bez pretpostavke da postoji — polling API-ja po vašem rasporedu sigurna je alternativa.
Postoji li sandbox okruženje?
Autoritativan odgovor nalazi se u aktualnoj API dokumentaciji. Ako je sandbox naveden, koristite ga za integracijsko testiranje. Ako nije naveden, nemojte kreirati prave plaćene narudžbe tijekom automatiziranih testova bez izričitog odobrenja — umjesto toga koristite namjensku testnu kampanju i ljudski pregled.
Mogu li API narudžbe koristiti Instant Publishing?
Dostupnost Instant Publishinga ovisi o tome ima li odabrana web-stranica podržanu automatiziranu integraciju za objavu (ili BlogDrip WordPress plugin ili Agency API konekciju). Bilo koja narudžba — API ili manualna — postavljena na web-stranici koja to podržava može imati automatiziranu objavu. Ne podržava svaka web-stranica u marketplaceu tu opciju, stoga bi vaša integracija trebala tretirati vrijeme objave kao ovisno o web-stranici, a ne uniformno.
Koja je razlika između Advertiser API-ja i Agency API-ja?
Advertiser API je namijenjen kupcima koji žele automatizirati naručivanje gostujućih članaka iz vlastitog softvera. Agency API je za vanjske agencije, platforme za link building i mreže izdavača koje žele povezati vlastiti inventar s BlogDripom i automatizirati podržano fulfilment. Oba su samostalna — korištenje jednog ne zahtijeva drugi.
Što se događa ako ponovno pošaljem neuspjeli zahtjev za kreiranje narudžbe?
Ako niste vidjeli potvrđeni odgovor, pretpostavite da je prvi zahtjev možda uspio na serverskoj strani. Nemojte automatski retry-ati ne-idempotentan zahtjev za kreiranje narudžbe. Dodajte server-side de-duplication ključ ili prvo upitajte postoji li potencijalno kreirana narudžba prije ponovnog slanja — što god vaš tijek rada čisti bolje podržava. Retry na uspješnu, ali nevidljivu narudžbu stvara dvostruku naplatu.
Spremni za automatizaciju link buildinga?
Otvorite API dokumentaciju, generirajte svoje vjerodajnice i počnite graditi. Marketplace skalira s vašom automatizacijom — ne obrnuto.