Vodnik za razvijalce
Zgradite svoje orodje za avtomatizacijo gradnje povezav z BlogDrip API
Povežite svojo programsko opremo neposredno z BlogDrip in avtomatizirajte naročanje gostujočih objav. Zgradite prilagojene SEO delovne procese, integrirajte obstoječe aplikacije in učinkoviteje upravljajte operacije gradnje povezav.
Zakaj avtomatizirati
Zakaj zgraditi svoje orodje za avtomatizacijo gradnje povezav
SEO agencije in notranje marketing ekipe naletijo na isti operativni vzorec: ročno iskanje priložnosti za objavo, ponovni vnos naročil za gostujoče objave, upravljanje več klientskih kampanj, prenašanje podatkov med notranjimi sistemi, spremljanje poteka naročil in poskus razširjanja vsega tega brez sorazmernega povečevanja števila zaposlenih.
Integracija preko API odstrani ponavljajoče se mehansko delo s krožnika vaše ekipe in ga usmeri v kodo. Vaša obstoječa programska oprema — CRM, orodje za upravljanje kampanj ali prilagojen nadzorni panel, v katerem vaša ekipa že deluje — se poveže neposredno s tržnico. Operaterji ostanejo osredotočeni na strategijo, briefinge in kontrolo kakovosti namesto na vnašanje naročil.
Avtomatizacija prinaša učinkovitost delovnih procesov, ne višjih SEO uvrstitev. Ne bo naredila slabe kampanje uspešne in ne nadomesti človeške presoje pri izbiri izdajateljev. Dobra stran avtomatizacije je, da odstrani plast vnosa podatkov, tako da ko se odločite, kaj kupiti, to lahko izvedete v poljubnem obsegu.
Kaj lahko zgradite
Kaj lahko zgradite z BlogDrip API
Praktični vzorci za programsko opremo, zgrajeno na programatični integraciji s tržnico.
Prilagojen nadzorni panel za gostujoče objave
Notranja aplikacija, ki se poveže z BlogDrip in pošlje podprta naročila gostujočih objav prek uporabniškega vmesnika, ki ga nadzoruje vaša ekipa.
Sistem za upravljanje SEO agencije
Naročanje gostujočih objav integrirano v obstoječi agencijski potek dela, tako da vodje kampanj nikoli ne zapustijo sistema, ki ga že uporabljajo.
Avtomatizirano oddajanje naročil
API zahtevki ustvarijo podprta naročila gostujočih objav v seriji, brez ročnega vnosa podatkov za vsako naročilo.
Upravljanje klientskih kampanj
Povežite notranje evidence strank in kampanj s postopki naročanja v BlogDrip — en sam vir resnice o tem, kdo kaj kupuje.
Avtomatizacija delovnih procesov
Sprožite podprte API operacije iz notranjih poslovnih procesov — odobritve, zagon, razporejena valovanja kampanj.
Poročanje in nadzor
Potegnite informacije o naročilih v prilagojena orodja za poročanje tam, kjer je to podprto. Omejite poročanje na tisto, kar API dejansko izpostavlja, namesto da domnevate popolno realnočasovno vidljivost.
Arhitektura
Primer arhitekture avtomatizacije
Zdrava integracija loči skrbi čez štiri sloje.
Na vrhu je vaša zunanja avtomatizacijska aplikacija — prilagojen nadzorni panel, programska oprema SEO agencije, notranji CRM ali sistem za upravljanje kampanj. To je prostor, kjer vaša ekipa dela vsakodnevno.
Pod tem je backend vaše aplikacije. Njegove odgovornosti so tiste, ki jih mora vsaka integracija izvesti pravilno: varno shranjevati `x-client-id` in `x-client-secret`, validirati vhodne podatke preden sploh dosežejo BlogDrip, pripraviti in poslati API zahtevke, obravnavati `{ data, pagination }` odgovore, beležiti operativne dogodke in upravljati ponovitve na varen način, da začasna omrežna motnja ne povzroči dvojnega plačanega naročila.
Nato zahtevki zadenejo BlogDrip Advertiser API — javno, verzionirano površino pod `/api/public/*` — ki izpostavlja podprto funkcionalnost naročanja gostujočih objav.
API usmerja naročila v BlogDrip tržnico — več kot 275,000+ spletnih mest skupnega inventarja — in od tam v ustrezen proces obdelave naročil in potek objave. Odvisno od izbranega spletnega mesta je objava lahko ročna na strani izdajatelja ali avtomatizirana preko vtičnika WordPress ali Agency API. Ne vsako spletno mesto v tržnici podpira Instant Publishing, zato naj vaša integracija obravnava čas objave kot odvisen od delovnega procesa, ne kot takojšen.
Zgradite svoje orodje za avtomatizacijo, korak za korakom
Osem korakov od opredelitve obsega do nadzora. Obravnavajte jih kot referenco, ne kot strogo zaporedje — mnogi te koraki tečejo vzporedno.
Opredelite svoj avtomatizacijski potek dela
Določite, katere naloge je smiselno avtomatizirati, katere informacije potrebuje vaša aplikacija, kdaj je treba oddati naročilo, kako preprečiti podvojena naročila, kako se obravnavajo napake in kako se shranjujejo podatki o kampanjah. Konkretni primer scoping-a: agencija, ki upravlja 20 klientov, vsak s 3–5 aktivnimi kampanjami, želi, da nove kampanje samodejno ustvarijo naročila za kratki seznam vnaprej odobljenih spletnih mest — vendar šele potem, ko človeški pregled potrdi brief kampanje.
Pridobite dostop do BlogDrip API
Odprite svoj račun na app.blogdrip.com/settings in pojdite v My Settings → API access, da najdete svoje poverilnice. Videli boste dve vrednosti: `x-client-id` in `x-client-secret`. Secret je prikazan enkrat, ko je izdan ali rotiran, zato ga takoj skopirajte v upravitelja skrivnosti. Dostop zahteva minimalno skupno porabo €500 na mesec — ročna naročila štejejo, API naročila štejejo, obe mesti skupaj. API dostop se samodejno deaktivira, če minimalna zahteva v danem mesecu ni izpolnjena. €500 je prag porabe, ne ločen naročninski strošek za API.
Preberite dokumentacijo API
Uradna dokumentacija na app.blogdrip.com/api/public/docs/index.html opisuje točne endpoint-e pod `/api/public/*` namespace-om, avtentikacijo (ti dve header pari, omenjeni zgoraj), metode zahtevkov, obvezne parametre, formate odgovorov (list endpoint-i zavijejo odgovore v `{ data, pagination }` z 0-based `?page=0`), validacijske napake (`{ message }`) in razpoložljive operacije naročanja. Dokumentacijo obravnavajte kot avtoritativni vir: če parameter ni dokumentiran, ne predvidevajte, da obstaja.
Zgradite API povezavo
Ustvarite backend aplikacije, ki varno shrani `x-client-id` in `x-client-secret` (okoljski spremenljivki, secret manager — nikoli v frontend kodi), pošilja avtorizirane zahteve z obema headerjema, parsira odgovore, obravnava napake in zapisuje strukturirane dnevnike za vsak odhodni klic. Naj bo API klient majulen, dobro preizkušen modul, da preostali del aplikacije nikoli ne komunicira neposredno z BlogDrip.
Implementirajte avtomatizirano naročanje gostujočih objav
Povežite notranji potek dela s podprtimi BlogDrip operacijami naročanja. Tipičen tok: v vašem sistemu se ustvari nova kampanja → izbere se spletno mesto (razrešite njegov `marketSiteId` iz marketplace endpoint-ov) → vaša aplikacija pripravi zahtevane podatke za naročilo (naslov, URL, opis, `categoryId`, `marketSiteId`, `campaignId`, opcijsko `scheduleDate`, `linkNoFollow`) → backend preveri naročilo proti vašim poslovnim pravilom → aplikacija odda naročilo preko Advertiser API → odgovor se shrani v vašem sistemu za sledljivost. Pred pošiljanjem validirajte vsako polje glede na OpenAPI spec.
Obravnavajte napake in podvojena naročila
Validirajte zahtevke pred oddajo, preprečite po nesreči podvojena naročila (idempotency ključ ali strežniška de-duplicacija je varen vzorec), beležite vsako odpoved API z dovolj konteksta za poznejše odpravljanje napak, obravnavajte začasne povezljivostne težave obzirno in spoštujte dokumentirane omejitve hitrosti. Pravilo, ki si ga zapomnite: nikoli samodejno ne ponavljajte ne-idempotentnega zahtevka za ustvarjanje naročila brez izrecne človeške ali sistemske potrditve — ponovitev pri uspešnem naročilu, za katerega niste videli odgovora, povzroči dvojno obremenitev.
Testirajte svojo integracijo
Poženite integracijo proti sandbox okolju, če je opisan v dokumentaciji. Če sandbox ni na voljo, testirajte v produkciji previdno — nikoli ne zaženite avtomatiziranih testnih paketov, ki ustvarjajo prava plačana naročila brez izrecnega pooblastila. Uporabite namensko testno kampanjo s človeškim pregledom pred prvim avtomatiziranim naročilom in omejite avtomatizirane testne zagone na kratko dovolilno listo spletnih mest, ki ste jih vnaprej odobrili za integracijsko testiranje.
Razporedite in nadzirajte
Prenesite poverilnice v proizvodni secret store, dodajte nadzor za neuspehe integracije in nenavadne vzorce oddajanja naročil, spremljajte rezultate oddaj naročil od začetka do konca, hranite operativne dnevnike dovolj dolgo, da odpravite incident izpred dva tedna, spremljajte porabo računa, da ne izgubite API dostopa zaradi padca pod mesečni minimum €500, in spremljajte BlogDrip changelog za API posodobitve, ki lahko zahtevajo vzdrževanje integracije.
Vzorce integracije
Kako izgleda zdrava integracija
Avtoritativni vir za izvršljive primere je OpenAPI specifikacija na app.blogdrip.com/api/public/openapi.json in človeku berljiva dokumentacija na /api/public/docs. Specifikacija je tista, proti kateri naj se vaša koda generira ali preverja — ne landing-page odlomek, ki lahko zastara.
V praksi čista integracija sledi podobni obliki. Tanek API-klient modul v vašem izbranem jeziku — ena zavijalna funkcija na operacijo, ki jo potrebujete — upravlja mehaniko: nastavi header-ja `x-client-id` in `x-client-secret` pri vsaki zahtevi, serializira telo zahtevka, deserializira `{ data, pagination }` ovojnico pri list endpointih (0-based paging), in pretvori napake v odgovoru (`{ message }`) v izjeme, ki jih lahko vaša poslovna logika čisto ujame. Vsak wrapper ima vsaj en test, ki preveri dokumentirano obliko, tako da sprememba sheme izplava kot napaka v testih preden pride v produkcijo. Šele ko je ta modul stabilen, ga povežete v preostali del aplikacije — sprožilci kampanj, vrste naročil, retry workerji, poročanje.
To zaporedje ohranja integracijo revizijsko sledljivo: vaš API klient je majhna, dobro testirana površina; vse ostalo komunicira z BlogDrip preko njega.
Priporočene prakse
Kaj naredi API integracijo vzdržljivo
Vzorce, ki ohranjajo avtomatizirane sisteme zdrave dolgo po začetku.
Idempotentnost po zasnovi
Obravnavajte ustvarjanje naročil kot drago in nezamenljivo. Pred pošiljanjem na vaši strani odstranjujte dvojnike — nikoli po.
Higiena poverilnic
API poverilnice sodijo v secret manager, ločeno za vsako okolje. Rotirajte jih ob odhodu, ne samo ob kršitvi.
Strukturirano beleženje
Vsak par zahteva + odgovor dobi correlation ID. Prihodnji vi, ki odpravljate staro naročilo, bo hvaležen sedanjim vam.
Client-i, ki upoštevajo omejitve hitrosti
Spoštujte dokumentirane rate limite. Client, ki se umakne čisto, se razširi bolje kot tisti, ki agresivno ponavlja.
Človek v zanki
Zaščitite prvi produkcijski klic s človeško odobritvijo. Avtomatizacijo razširite šele, ko je integracija dokazano stabilna.
Spremljanje porabe
Pošljite alarm, ko mesečna poraba računa trende proti ali pod €500. Izguba API dostopa sredi kampanje je boleča.
Pogosto zastavljena vprašanja
Za koga je BlogDrip API namenjen?
Advertiser računi, ki želijo povezati svojo programsko opremo — prilagojen nadzorni panel, platformo SEO agencije, notranji CRM — z BlogDrip potekom naročanja gostujočih objav. Tipični uporabniki so agencije, ki upravljajo kampanje v obsegu, notranje SEO ekipe, ki integrirajo obstoječi stack, in razvijalci, ki gradijo operativna orodja za specifičnega klienta ali produkt.
Ali moram biti razvijalec, da uporabljam API?
Za izgradnjo same integracije, da. API je programski vmesnik — njegovo uporabo zahteva pisanje kode ali sodelovanje z razvijalcem. Če želite operativne koristi brez integracijskega dela, uporabniški vmesnik tržnice pokriva enako funkcionalnost naročanja ročno.
Kateri so pogoji za dostop?
Aktiven BlogDrip račun, ki porabi vsaj €500 mesečno skupaj — ročna in API naročila se štejejo k pragu. API dostop se samodejno deaktivira, če vaš račun v določenem mesecu porabi manj. €500 je volumenski prag, ne ločen naročninski strošek za API.
Kje najdem dokumentacijo API?
Uradna dokumentacija API je objavljena na app.blogdrip.com/api/public/docs/index.html, z machine-readable OpenAPI specifikacijo na app.blogdrip.com/api/public/openapi.json. Obe opisujeta avtentikacijski shemo, celoten katalog endpoint-ov pod `/api/public/*` namespace-om, oblike zahtevkov in odgovorov, format paginacije in napake v odgovorih. Obdelujte ju kot vir resnice za vašo integracijo.
Kje najdem svoje API poverilnice?
V My Settings → API access na app.blogdrip.com/settings. Dobite `x-client-id` in `x-client-secret`; oba gresta v vsak avtoriziran zahtevek kot HTTP headerja. Secret je prikazan enkrat ob izdaji ali rotaciji — takoj ga skopirajte v upravitelja skrivnosti, saj ga pozneje ni mogoče pridobiti. Poverilnice so vezane na račun; obravnavajte jih kot vsako drugo skrivnost in jih ne shranjujte v nadzoru različic.
Kako deluje paginacija na list endpointih?
List endpoint-i zavijejo svoje odgovore v `{ data, pagination }` ovojnico in uporabljajo 0-based paging — pošljite `?page=0` za prvo stran, `?page=1` za drugo itd. Paginacijski blok v odgovoru pove, ali obstajajo dodatne strani. Če migrirate iz legacy `/api/<path>` vmesnika, se oblika odgovora ne spremeni — spremeni se le osnovna pot v `/api/public/*`.
Ali API podpira webhooks?
Preverite OpenAPI spec na app.blogdrip.com/api/public/openapi.json za trenutni seznam podprtih mehanizmov za povratne klice ali obvestila o dogodkih. Če funkcija ni navedena, zgradite integracijo brez predpostavke, da obstaja — polling API po vašem urniku je varen nadomestek.
Ali obstaja sandbox okolje?
Avtoritativni odgovor je v trenutni dokumentaciji API. Če je sandbox naveden, ga uporabite za integracijsko testiranje. Če ni naveden, med avtomatiziranim testiranjem ne ustvarjajte pravih plačanih naročil brez izrecnega pooblastila — namesto tega uporabite namensko testno kampanjo in človeški pregled.
Ali lahko API naročila uporabijo Instant Publishing?
Dostopnost Instant Publishing je odvisna od tega, ali izbrano spletno mesto podpira avtomatizirano integracijo objave (bodisi BlogDrip WordPress vtičnik bodisi povezava preko Agency API). Vsako naročilo — API ali ročno — na upravičenem spletnem mestu lahko koristi avtomatizirano objavo. Ne vsako spletno mesto v tržnici to podpira, zato naj integracija obravnava čas objave kot odvisen od posameznega spletnega mesta, ne enoten.
Kakšna je razlika med Advertiser API in Agency API?
Advertiser API je za stranke, ki želijo avtomatizirati naročanje gostujočih objav iz svoje programske opreme. Agency API je za zunanje agencije, platforme za gradnjo povezav in mreže izdajateljev, ki želijo povezati svoj inventar z BlogDrip in avtomatizirati podprto izpolnjevanje. Obe sta samostojni — uporaba enega ne zahteva drugega.
Kaj se zgodi, če ponovim neuspešen zahtevek za ustvarjanje naročila?
Če niste videli potrjenega odgovora, predpostavite, da je prvi zahtevek morda uspel na strežniški strani. Ne ponavljajte samodejno ne-idempotentnega zahtevka za ustvarjanje naročila. Dodajte strežniški de-duplication ključ ali poizvedujte za morebiti ustvarjeno naročilo preden poskusite znova — kar koli vaš potek dela podpira čisto. Ponovitev pri uspešnem-a vendar nevidnem naročilu ustvari dvojno obremenitev.
Ste pripravljeni avtomatizirati gradnjo povezav?
Odprite dokumentacijo API, ustvarite poverilnice in začnite graditi. Tržnica se razširi z vašo avtomatizacijo — ne obratno.