Kūrėjo vadovas
Sukurkite nuorodų kūrimo automatizavimo įrankį su BlogDrip API
Prijunkite savo programinę įrangą tiesiogiai prie BlogDrip ir automatizuokite svečio įrašų užsakymus. Kurkite individualias SEO darbo eigas, integruokite esamas programas ir valdykite nuorodų kūrimo operacijas efektyviau.
Kodėl automatizuoti
Kodėl verta kurti savo nuorodų kūrimo automatizavimo įrankį
SEO agentūros ir vidinės rinkodaros komandos susiduria su tuo pačiu operaciniu modeliu: rankiniu būdu ieško publikavimo galimybių, pakartotinai įveda svečio įrašų užsakymus, tvarkosi su keliomis klientų kampanijomis, perduoda informaciją tarp vidaus sistemų, stebi užsakymų pažangą ir bando visą tai išplėsti neproporcingai nepadidinant darbuotojų skaičiaus.
API integracija nuima pasikartojantį mechaninį darbą nuo jūsų komandos pečių ir nukreipia jį per kodą. Jūsų esama programinė įranga — CRM, kampanijų valdymo įrankis arba individualus valdymo skydelis, kuriame jau dirba jūsų komanda — bendrauja tiesiogiai su prekyviete. Operatoriai lieka susitelkę į strategiją, užduočių aprašymus ir kokybės kontrolę, o ne į užsakymų įvedimą.
Automatizacija suteikia darbo eigos efektyvumą, ne SEO reitingų padidėjimą. Ji neišgelbės prastos kampanijos ir nepakeis žmogaus sprendimo dėl leidėjo pasirinkimo. Ji gerai pašalina duomenų įvedimo sluoksnį, todėl, kai nuspręsite, ką pirkti, galėsite tai vykdyti bet kokiu kiekiu.
Ką galite sukurti
Ką galite sukurti naudodami BlogDrip API
Praktiniai modeliai programoms, sukurtoms ant programinės prekyvietės integracijos.
Individualus svečio įrašų skydelis
Vidaus programa, kuri prisijungia prie BlogDrip ir pateikia palaikomus svečio įrašų užsakymus per jūsų komandai valdomą sąsają.
SEO agentūros valdymo sistema
Svečio įrašų užsakymų integracija į esamą agentūros darbo eigą, todėl kampanijų vadovai niekada neišeina iš sistemos, kuria jau naudojasi.
Automatinis užsakymų pateikimas
API užklausos masiškai sukuria palaikomus svečio įrašų užsakymus be rankinio įvedimo kiekvienam užsakymui.
Klientų kampanijų valdymas
Junginkite vidinius klientų ir kampanijų įrašus su BlogDrip užsakymų darbo eigomis — vienas tiesos šaltinis, kas ką perka.
Darbo eigos automatizavimas
Paleiskite palaikomus API veiksmus iš vidinių verslo procesų — patvirtinimų, pradžios įvykių, suplanuotų kampanijų bangų.
Ataskaitos ir stebėsena
Traukite su užsakymais susijusią informaciją į pasirinktines ataskaitų priemones, kur tai palaikoma. Apribokite ataskaitas tuo, ką API tikrai atskleidžia, o ne manykite, kad yra visiška realaus laiko matomybė.
Architektūra
Pavyzdinė automatizacijos architektūra
Tvari integracija atskiria atsakomybes keturiuose sluoksniuose.
Viršuje yra jūsų išorinė automatizacijos programa — individualus valdymo skydelis, SEO agentūros programinė įranga, vidinis CRM arba kampanijų valdymo sistema. Čia jūsų komanda dirba kasdien.
Po ja yra jūsų programos backend'as. Jo atsakomybės — tai, ką kiekviena integracija privalo atlikti teisingai: saugiai saugoti `x-client-id` ir `x-client-secret`, validuoti įvestį dar prieš jai pasiekiant BlogDrip, paruošti ir siųsti API užklausas, tvarkyti `{ data, pagination }` atsakymus, registruoti operacinius įvykius ir saugiai valdyti bandymus pakartoti, kad trumpalaikis tinklo sutrikimas nevestų prie dvigubo apmokėto užsakymo.
Iš ten užklausos pasiekia BlogDrip Advertiser API — viešą, versijuotą paviršių po `/api/public/*` — kuris atskleidžia palaikomą svečio įrašų užsakymo funkcionalumą.
API nukreipia užsakymus į BlogDrip prekyvietę — daugiau nei 275,000 svetainių bendro inventoriaus — ir iš ten į taikomą užsakymų apdorojimo ir publikavimo darbo eigą. Priklausomai nuo pasirinktos svetainės, publikavimas gali būti rankinis leidėjo pusėje arba automatizuotas per WordPress įskiepį arba Agency API. Ne visos prekyvietės svetainės palaiko Momentinį publikavimą, todėl jūsų integracija turėtų traktuoti publikavimo laiką kaip priklausomą nuo darbo eigos, o ne akimirksninį.
Sukurkite savo automatizacijos įrankį žingsnis po žingsnio
Aštuoni žingsniai nuo apibrėžimo iki stebėsenos. Traktuokite juos kaip nuorodą, ne griežtą seką — daugelis vyksta lygiagrečiai.
Apibrėžkite darbo eigą
Nustatykite, kurios užduotys turėtų būti automatizuotos, kokios informacijos reikia jūsų programai, kada turi būti pateiktas užsakymas, kaip išvengsite dubliavimo, kaip tvarkomos klaidos ir kaip saugomas kampanijų duomenų modelis. Konkretus apimties pavyzdys: agentūra, valdanti 20 klientų, kiekvienam turinčią po 3–5 aktyvias kampanijas, nori, kad naujos kampanijos automatiškai generuotų užsakymus iš iš anksto patvirtintų svetainių trumpojo sąrašo — bet tik po to, kai žmogus patvirtina kampanijos briefą.
Gaukite prieigą prie BlogDrip API
Atidarykite savo paskyrą app.blogdrip.com/settings ir eikite į Mano nustatymai → API prieiga, kad rastumėte savo kredencialus. Matysite du reikšmių laukus: `x-client-id` ir `x-client-secret`. Slaptažodis rodomas vieną kartą jį išleidus arba pakeitus, todėl nedelsdami nukopijuokite jį į savo slaptų raktų saugyklą. Prieiga reikalauja minimalių mėnesinių išlaidų — iš viso ne mažiau nei €500 per mėnesį — tiek rankiniai, tiek per API pateikti užsakymai skaičiuojami. Jei mėnesinis išlaidų lygis nepasiekia minimaus, API prieiga automatiškai deaktyvuojama. €500 yra išlaidų slenkstis, ne atskira API prenumeratos mokesčio įmoka.
Perskaitykite API dokumentaciją
Oficiali dokumentacija app.blogdrip.com/api/public/docs/index.html aprašo tikslius galinius taškus po `/api/public/*` vardyno, autentifikaciją (minėtus du antraščių poras), užklausų metodus, privalomus parametrus, atsakymų formatus (sąrašų endpoint'ai apgaubia atsakymus `{ data, pagination }` su 0 bazine `?page=0` numeracija), validacijos klaidas (`{ message }`) ir prieinamas užsakymų operacijas. Traktuokite dokumentaciją kaip autoritetingą šaltinį: jei parametras nėra dokumentuotas, neverskite jo egzistuojančiu.
Sukurkite API ryšį
Sukurkite programos backend'ą, kuris saugiai saugo tiek `x-client-id`, tiek `x-client-secret` (aplinkos kintamieji, slaptų raktų saugykla — niekada kliento pusėje), siunčia autentifikuotas užklausas su abiem antraštėmis, analizuoja atsakymus, tvarko klaidas ir rašo struktūruotus žurnalus kiekvienam išeinančiam kvietimui. Laikykite API klientą kaip mažą, gerai ištestuotą modulį, kad visa likusi programos dalis niekada nekalbėtų su BlogDrip tiesiogiai.
Įgyvendinkite automatizuotus užsakymus
Sujunkite vidinę darbo eigą su palaikomomis BlogDrip užsakymų operacijomis. Tipinis srautas: nauja kampanija sukurta jūsų sistemoje → pasirenkama svetainė (išspręskite jos `marketSiteId` iš prekyvietės endpoint'ų) → jūsų programa paruošia reikiamą užsakymo informaciją (pavadinimas, URL, aprašymas, `categoryId`, `marketSiteId`, `campaignId`, pasirenkama `scheduleDate`, `linkNoFollow`) → backend'as patikrina užsakymą pagal jūsų verslo taisykles → programa pateikia užsakymą per Advertiser API → atsakymas saugomas jūsų sistemoje, kad būtų užtikrintas atsekamumas. Prieš pateikdami patikrinkite kiekvieną lauką pagal OpenAPI spec.
Tvarkykite klaidas ir dubliavimą
Validuokite užklausas prieš pateikimą, užkirstkite kelią atsitiktiniam užsakymų dubliavimui (idempotentiškumo raktas arba serverio pusės deduplikacijos patikra jūsų pusėje yra saugus modelis), registruokite kiekvieną API klaidą su pakankamai konteksto, kad vėliau būtų galima išsiaiškinti priežastis, maloniai spręskite laikinus ryšio sutrikimus ir gerbkite dokumentuotus ribojimus. Viena taisyklė: niekada automatiškai neatkartokite neidempotentinės užsakymo kūrimo užklausos be aiškaus žmogaus arba sistemos patvirtinimo — pakartojimas gavus sėkmingą, bet nematytą atsakymą sukurs dvigubą apmokestinimą.
Išbandykite integraciją
Paleiskite integraciją prieš bandomąją (sandbox) aplinką, jei ji aprašyta dokumentacijoje. Jei bandomoji aplinka nėra prieinama, testuokite produkciją atsargiai — niekada nepaleiskite automatizuotų testų, kurie kuria tikrus apmokamus užsakymus be aiškios autorizacijos. Naudokite atskirą testinę kampaniją su žmogumi procese peržiūrai prieš pirmą automatizuotą užsakymą ir apribokite automatizuotus bandomuosius paleidimus trumpu leidžiamų svetainių sąrašu, kurias iš anksto patvirtinote testavimui.
Diegimas ir stebėsena
Perkelkite kredencialus į gamybinę slaptų raktų saugyklą, pridėkite stebėseną dėl integracijos gedimų ir neįprastų užsakymų pateikimo modelių, sekite užsakymų pateikimo rezultatus nuo pradžios iki pabaigos, saugokite operacinius žurnalus pakankamai ilgai, kad būtų galima išspręsti dvi savaites seną incidentą, stebėkite savo paskyros išlaidas, kad neprarastumėte API prieigos dėl to, kad nukrenta žemiau €500 mėnesinio minimumo, ir stebėkite BlogDrip pakeitimų žurnalą dėl API atnaujinimų, kurie gali reikalauti priežiūros.
Integracijos modeliai
Kaip atrodo tinkama integracija
Autoritetingas vykdomųjų pavyzdžių šaltinis yra OpenAPI specifikacija app.blogdrip.com/api/public/openapi.json ir žmogui skaitomi dokumentai /api/public/docs. Specifikacija yra tai, pagal ką turėtų būti generuojamas arba tikrinamas jūsų kodas — ne tik svetainės fragmentas, kuris gali pasenti.
Praktikoje švari integracija dažniausiai turi panašią struktūrą. Plonas API kliento modulis jūsų pageidaujama kalba — po vieną apvyniojimo funkciją kiekvienai reikalingai operacijai — tvarko mechaniką: nustato `x-client-id` ir `x-client-secret` antraštes kiekvienoje užklausoje, serializuoja užklausos kūną, deserializuoja `{ data, pagination }` voką sąrašų endpoint'uose (0 bazinis puslapiavimas) ir paverčia klaidų atsakymus (`{ message }`) į išimtis, kurias jūsų verslo logika gali tvarkingai pagauti. Kiekvienas apvyniojimas turi bent vieną testą, patikrinantį dokumentuotą formą, tad schemos pasikeitimas pasimato kaip nepavykęs testas dar prieš patekimą į produkciją. Tik kai tas modulis yra stabilus, jį sujungiate su likusia programos dalimi — kampanijų triggeriais, užsakymų eilėmis, retry darbuotojais, ataskaitomis.
Tokia seka palaiko integracijos auditą: jūsų API klientas yra siauras, gerai ištestuotas paviršius; visa kita komunikuoja su BlogDrip per jį.
Geriausios praktikos
Kas užtikrina ilgalaikę API integraciją
Modeliai, kurie palaiko stabilias automatizuotas sistemas ilgai po paleidimo.
Idempotentiškumas pagal dizainą
Laikykite užsakymo kūrimą brangiu ir negrįžtamu. Pašalinkite pasikartojimus savo pusėje prieš siunčiant užklausą — niekada po to.
Kredencialų higiena
API kredencialai turi būti saugomi slaptų raktų saugykloje, priskirti kiekvienai aplinkai atskirai. Keiskite juos išeinant darbuotojui, o ne tik po pažeidimo.
Struktūruoti žurnalai
Kiekvienai užklausai ir atsakymui priskirkite koreliacijos ID. Ateities Jūs, derindami seną užsakymą, dėkos dabartiniam Jums.
Klientai, jautrūs ribojimams
Laikykitės dokumentuotų užklausų dažnio ribų. Klientas, kuris tvarkingai sumažina apkrovą, geriau išsiplės nei agresyviai bandantis pakartoti.
Žmogus procese
Pirmą gamybinį kvietimą apsaugokite žmogaus patvirtinimu. Plėskite automatizaciją tik kai integracija įrodyta kaip stabili.
Išlaidų stebėsena
Įspėkite, kai mėnesinės paskyros išlaidos linksta link arba nukrenta žemiau €500. Prarasti API prieigą kampanijos metu yra skaudu.
Dažniausiai užduodami klausimai
Kam skirta BlogDrip API?
Reklamuotojų paskyroms, kurios nori prijungti savo programinę įrangą — individualų valdymo skydelį, SEO agentūros platformą ar vidinį CRM — prie BlogDrip svečio įrašų užsakymų darbo eigos. Tipiniai vartotojai: agentūros, valdžiusios kampanijas dideliu kiekiu, vidinės SEO komandos, integruojančios esamą technologijų rinkinį, ir programuotojai, kuriantys operacinius įrankius specifiniam klientui ar produktui.
Ar reikia būti programuotoju, kad naudotis API?
Norint sukurti pačią integraciją — taip. API yra programinė sąsaja — jos naudojimas reikalauja kodo rašymo arba bendradarbiavimo su programuotoju. Jei norite operacinių privalumų be integracijos darbo, prekyvietės vartotojo sąsaja rankiniu būdu suteikia tą pačią užsakymo funkcionalumą.
Kokie prieigos reikalavimai?
Aktyvi BlogDrip paskyra, kuri bendromis išlaidomis išleidžia bent €500 per mėnesį — tiek rankiniai, tiek per API pateikti užsakymai skaičiuojami. Jei paskyros išlaidos per mėnesį nesiekia minimumo, API prieiga automatiškai deaktyvuojama. €500 yra apimties slenkstis, ne atskira API prenumeratos įmoka.
Kur rasti API dokumentaciją?
Oficiali API dokumentacija publikuojama app.blogdrip.com/api/public/docs/index.html, o mašinai skaitoma OpenAPI specifikacija yra app.blogdrip.com/api/public/openapi.json. Abu šaltiniai aprašo autentifikacijos schemą, visą galinių taškų katalogą po `/api/public/*` vardyno, užklausų ir atsakymų formas, puslapiavimo formatą ir klaidų atsakymus. Traktuokite juos kaip tiesos šaltinį savo integracijai.
Kur rasti mano API kredencialus?
Mano nustatymai → API prieiga app.blogdrip.com/settings. Ten gausite `x-client-id` ir `x-client-secret`; abu įtraukiami į kiekvieną autentifikuotą užklausą kaip HTTP antraštės. Slaptažodis rodomas vieną kartą jį išleidus arba pakeitus — nedelsdami nukopijuokite jį į savo slaptų raktų saugyklą, nes vėliau jo nebus galima atgauti. Kredencialai yra priskiriami paskyrai; traktuokite juos kaip bet kokį kitą slaptą duomenį ir nelaikykite versijų valdyme.
Kaip veikia puslapiavimas sąrašų endpoint'uose?
Sąrašų endpoint'ai apgaubia savo atsakymus `{ data, pagination }` struktūra ir naudoja 0 bazinį puslapiavimą — perduokite `?page=0` pirmajam puslapiui, `?page=1` antram ir t. t. Puslapiavimo blokas atsakyme nurodo, ar egzistuoja papildomi puslapiai. Jei migruojate nuo senosios `/api/<path>` sąsajos, atsakymo forma nepasikeitė — tik bazinis kelias persikėlė į `/api/public/*`.
Ar API palaiko grįžtamojo kvietimo mechanizmus (webhook'us)?
Patikrinkite OpenAPI specifikaciją app.blogdrip.com/api/public/openapi.json, kur nurodytas šiuo metu palaikomų atgalinio kvietimo ar įvykių pranešimų mechanizmų sąrašas. Jei funkcija nėra išvardinta, kurdami integraciją nepriimkite, kad ji egzistuoja — API periodiškas tikrinimas pagal jūsų grafiką yra saugus atsarginis sprendimas.
Ar yra bandomoji (sandbox) aplinka?
Autoritetingas atsakymas pateikiamas dabartinėje API dokumentacijoje. Jei sąraše nurodyta bandomoji aplinka, naudokite ją integracijos testavimui. Jei jos nėra, neatlikinėkite automatizuotų testų, kurie kuria tikrus apmokamus užsakymus be aiškios autorizacijos — vietoje to naudokite atskirą testinę kampaniją ir žmogaus patvirtinimą.
Ar API užsakymai gali naudoti Momentinį publikavimą?
Momentinio publikavimo prieinamumas priklauso nuo pasirinktos svetainės turimo automatizuoto publikavimo integracijos (ar tai būtų BlogDrip WordPress įskiepis, ar Agency API ryšys). Bet kurie užsakymai — tiek per API, tiek rankiniu būdu — pateikti į palaikomą svetainę gali pasinaudoti automatizuotu publikavimu. Ne visos prekyvietės svetainės tai palaiko, todėl jūsų integracija turėtų traktuoti publikavimo laiką kaip priklausomą nuo konkrečios svetainės, ne vienodai.
Kuo skiriasi Advertiser API ir Agency API?
Advertiser API skirta klientams, kurie nori automatizuoti svečio įrašų užsakymus iš savo programinės įrangos. Agency API skirta išorinėms agentūroms, nuorodų kūrimo platformoms ir leidėjų tinklams, kurie nori prijungti savo inventorių prie BlogDrip ir automatizuoti palaikomą įvykdymą. Abi sąsajos yra nepriklausomos — naudojant vieną, nereikia kito.
Kas nutinka, jei pakartoju nepavykusį užsakymo kūrimo užklausimą?
Jei nematėte patvirtinančio atsakymo, laikykite, kad pirmoji užklausa galimai buvo įvykdyta serverio pusėje. Niekada automatiškai neatkartokite neidempotentinės užsakymo kūrimo užklausos. Pridėkite serverio pusės deduplikacijos raktą arba prieš bandant pakartoti užklausą užklauskite ar užsakymas jau galėjo būti sukurtas — rinkitės tą modelį, kurį jūsų darbo eiga tvarkingai palaiko. Pakartojimas sėkmingo, bet nematyto užsakymo atveju sukurs dvigubą apmokestinimą.
Pasiruošę automatizuoti savo nuorodų kūrimą?
Atidarykite API dokumentaciją, sugeneruokite kredencialus ir pradėkite kurti. Prekyvietė plečiasi kartu su jūsų automatizacija — ne atvirkščiai.