Sprievodca pre vývojárov
Vytvorte nástroj na automatizáciu budovania odkazov s BlogDrip API
Prepojte svoj softvér priamo s BlogDrip a automatizujte objednávanie hosťujúcich článkov. Vytvorte vlastné SEO workflowy, integrujte existujúce aplikácie a efektívnejšie spravujte operácie budovania odkazov.
Prečo automatizovať
Prečo si vytvoriť vlastný nástroj na automatizáciu budovania odkazov
SEO agentúry a interné marketingové tímy narážajú na rovnaký operačný vzorec: manuálne hľadajú možnosti publikovania, opakovane zadávajú objednávky hosťujúcich článkov, manažujú viaceré kampane klientov, prenášajú informácie medzi internými systémami, sledujú priebeh objednávok a snažia sa to všetko škálovať bez adekvátneho navýšenia počtu ľudí.
Integrácia cez API odoberie opakovanú mechanickú prácu z pliec tímu a spracuje ju kódom. Váš existujúci softvér — CRM, nástroj na správu kampaní alebo vlastný dashboard, v ktorom tím bežne pracuje — komunikuje priamo s trhoviskom. Operátori sa môžu sústrediť na stratégiu, zadania a kontrolu kvality namiesto manuálneho zadávania objednávok.
Automatizácia prináša efektívnosť pracovných tokov, nie vyššie SEO pozície. Nezaručí úspech zlej kampane a nenahradí ľudský úsudok pri výbere vydavateľov. Dobre však odstráni vrstvu zadávania dát, takže keď rozhodnete čo kúpiť, môžete to vykonať v akomkoľvek objeme.
Čo môžete vytvoriť
Čo môžete vytvoriť s BlogDrip API
Praktické vzory pre softvér postavený nad programatickou integráciou s trhoviskom.
Vlastný panel pre hosťujúce články
Interná aplikácia, ktorá sa pripojí k BlogDrip a odošle podporované objednávky hosťujúcich článkov z UI, ktoré váš tím kontroluje.
Systém pre riadenie SEO agentúry
Objednávanie hosťujúcich článkov zapojené do existujúceho agentúrneho workflowu, aby manažéri kampaní nikdy nemuseli opustiť systém, ktorý už používajú.
Automatické odosielanie objednávok
API požiadavky vytvárajú podporované objednávky hosťujúcich článkov v dávkach, bez manuálneho zadávania pre každú objednávku.
Správa klientskych kampaní
Prepojte interné záznamy o klientoch a kampaniach s objednávacími workflowmi BlogDrip — jedno zdroj pravdy o tom, kto čo kupuje.
Automatizácia pracovných tokov
Spúšťajte podporované API operácie z interných obchodných procesov — schválenia, spustenia, plánované vlny kampaní.
Reporting a monitoring
Načítajte informácie súvisiace s objednávkami do vlastných reportovacích nástrojov, kde je to podporované. Prispôsobte reportovanie tomu, čo API skutočne vystavuje, namiesto predpokladu plnej reálnej viditeľnosti.
Architektúra
Príklad architektúry automatizácie
Zdravá integrácia rozdeľuje zodpovednosti naprieč štyrmi vrstvami.
Navrchu je vaša externá automatizačná aplikácia — vlastný dashboard, softvér SEO agentúry, interné CRM alebo systém na správu kampaní. Tu váš tím pracuje každý deň.
Pod ňou sedí backend vašej aplikácie. Jeho zodpovednosti sú tie, ktoré musí mať každá integrácia: bezpečne uložiť `x-client-id` a `x-client-secret`, validovať vstupy skôr než vôbec dorazia do BlogDrip, pripraviť a odosielať API požiadavky, spracovať `{ data, pagination }` odpovede, logovať prevádzkové udalosti a bezpečne spravovať retry mechanizmy, aby dočasný výpadok siete neviedol k duplikovanej platenej objednávke.
Odtiaľ požiadavky zasiahnu BlogDrip Advertiser API — verejný, verzionovaný povrch pod `/api/public/*` — ktorý vystavuje podporovanú funkcionalitu objednávania hosťujúcich článkov.
API nasmeruje objednávky do BlogDrip trhoviska — viac než 275,000 webov v celkovom inventári — a odtiaľ do príslušného procesu spracovania objednávok a workflowu publikovania. Podľa vybraného webu môže byť publikovanie na strane vydavateľa manuálne alebo automatizované cez WordPress plugin alebo Agency API. Nie každý web v trhovisku podporuje Instant Publishing, preto by mala vaša integrácia považovať čas publikovania za závislý od workflowu, nie za okamžitý.
Vytvorte svoj automatizačný nástroj, krok za krokom
Osem krokov od rozsahu až po monitoring. Považujte ich za referenciu, nie striktné poradie — mnoho z nich beží paralelne.
Definujte svoj automatizačný workflow
Identifikujte úlohy, ktoré by mali byť automatizované, aké informácie potrebuje vaša aplikácia, kedy by mala byť objednávka odoslaná, ako sa zabrání duplicitným objednávkam, ako sa riešia chyby a ako sa ukladajú dáta kampaní. Konkrétny príklad rozsahu: agentúra spravujúca 20 klientov, každý s 3–5 aktívnymi kampaňami, chce, aby nové kampane automaticky generovali objednávky pre predvybrané weby — ale len po tom, čo človek schváli brief kampane.
Získajte prístup k BlogDrip API
Otvorte účet na app.blogdrip.com/settings a prejdite do Moje nastavenia → Prístup k API, kde nájdete svoje poverenia. Uvidíte dve hodnoty: `x-client-id` a `x-client-secret`. Secret sa zobrazí iba raz pri vydaní alebo rotácii, preto ho ihneď skopírujte do svojho secret managera. Prístup vyžaduje minimálne €500 mesačne v celkových výdavkoch účtu — manuálne objednávky sa počítajú, API objednávky sa počítajú, obe dráhy spolu. API prístup sa automaticky deaktivuje, ak minimum nie je v danom mesiaci splnené. €500 je prah výdavkov, nie samostatný poplatok za API.
Prečítajte si dokumentáciu API
Oficiálna dokumentácia na app.blogdrip.com/api/public/docs/index.html opisuje presné endpointy pod namespace `/api/public/*`, autentifikáciu (dvojicu hlavičiek spomenutú vyššie), metódy požiadaviek, povinné parametre, formáty odpovedí (list endpointy obalujú odpovede v `{ data, pagination }` s 0-based `?page=0`), validačné chyby (`{ message }`) a dostupné objednávacie operácie. Považujte dokumentáciu za autoritatívny zdroj: ak parameter nie je zdokumentovaný, nepripúšťajte, že existuje.
Vytvorte API pripojenie
Vytvorte backend aplikácie, ktorý bezpečne uloží `x-client-id` aj `x-client-secret` (environment variables, secret manager — nikdy vo frontend kóde), odosiela autorizované požiadavky s oboma hlavičkami nastavenými, parsuje odpovede, rieši chyby a zapisuje štruktúrované logy pre každý odchádzajúci call. Držte API klienta ako malý, dobre otestovaný modul, aby zvyšok aplikácie nikdy nekomunikoval s BlogDrip priamo.
Implementujte automatizované objednávanie hosťujúcich článkov
Prepojte svoj interný workflow s podporovanými objednávacími operáciami BlogDrip. Typický tok: v systéme sa vytvorí nová kampaň → vyberie sa web (zistite jeho `marketSiteId` z endpointov trhoviska) → vaša aplikácia pripraví požadované údaje objednávky (názov, URL, popis, `categoryId`, `marketSiteId`, `campaignId`, voliteľné `scheduleDate`, `linkNoFollow`) → backend overí objednávku voči vašim obchodným pravidlám → aplikácia odošle objednávku cez Advertiser API → odpoveď sa uloží vo vašom systéme pre audit. Validujte každé pole podľa OpenAPI špecifikácie pred odoslaním.
Riešte chyby a duplicitné objednávky
Validujte požiadavky pred odoslaním, zabráňte neúmyselným duplicitným objednávkam (idempotency key alebo server-side de-duplication check na vašej strane je bezpečný vzor), logujte každé zlyhanie API s dostatočným kontextom na neskoršie debugovanie, zvládajte dočasné sieťové problémy elegantne a rešpektujte akékoľvek zdokumentované rate limity. Jedno pravidlo na zapamätanie: nikdy automaticky neretryujte ne-idempotentnú požiadavku na vytvorenie objednávky bez explicitného ľudského alebo systémového potvrdenia — retry pri objednávke, pri ktorej ste nevideli odpoveď, môže spôsobiť dvojité zúčtovanie.
Testujte svoju integráciu
Spustite integráciu proti sandbox prostrediu, ak je v dokumentácii uvedené. Ak sandbox nie je k dispozícii, testujte proti produkcii opatrne — nikdy nespúšťajte automatizované testy, ktoré vytvárajú reálne platené objednávky bez explicitného povolenia. Použite vyhradenú testovaciu kampaň s človekom v slučke pred prvou automatizovanou objednávkou a obmedzte automatizované testy na krátky zoznam predschválených webov pre integračné testovanie.
Nasadiť a monitorovať
Presuňte poverenia do produkčného secret store, pridajte monitoring pre zlyhania integrácie a neobvyklé vzory odosielania objednávok, sledujte výsledky odoslania objednávok end-to-end, uchovávajte operačné logy dostatočne dlho na debug incidentu starého dva týždne, monitorujte výdavky účtu, aby ste nestratili API prístup poklesom pod €500 mesačný minimum, a sledujte BlogDrip changelog pre aktualizácie API, ktoré môžu vyžadovať údržbu integrácie.
Vzory integrácie
Ako vyzerá zdravá integrácia
Autoritatívnym zdrojom pre spustiteľné príklady je OpenAPI špecifikácia na app.blogdrip.com/api/public/openapi.json a ľudsky čitateľná dokumentácia na /api/public/docs. Špecifikácia je to, proti čomu by mal byť váš kód generovaný alebo validovaný — nie landing-page útržok, ktorý môže zostarnúť.
V praxi má čistá integrácia tendenciu nasledovať rovnaký tvar. Tenký API-klient modul v preferovanom jazyku — jedna wrapper funkcia na každú potrebnú operáciu — rieši mechaniku: nastavuje hlavičky `x-client-id` a `x-client-secret` na každej požiadavke, serializuje telo požiadavky, deserializuje `{ data, pagination }` obálku na list endpointoch (0-based paging) a prevádza chybové odpovede (`{ message }`) na výnimky, ktoré môže vaša biznis logika čisto zachytiť. Každý wrapper má aspoň jeden test overujúci zdokumentovaný tvar, takže zmena schémy sa prejaví ako zlyhaný test pred vstupom do produkcie. Až keď je ten modul stabilný, zapojíte ho do zvyšku aplikácie — spúšťače kampaní, fronty objednávok, retry workery, reporting.
Toto poradie udržiava integráciu auditovateľnú: váš API klient je malá, dobre otestovaná povrchová oblasť; všetko ostatné s BlogDrip komunikuje cez neho.
Osvedčené postupy
Čo udržuje API integráciu dlhodobo funkčnú
Vzory, ktoré udržiavajú automatizované systémy zdravé dlho po dni spustenia.
Idempotencia navrhnutá od začiatku
Považujte vytvorenie objednávky za nákladné a nezvratné. Deduplicujte na vašej strane pred odoslaním požiadavky — nikdy až potom.
Hygiena poverení
API poverenia patria do secret managera, rozdelené podľa prostredia. Rotujte ich pri odchode, nie až po incidente.
Štruktúrované logovanie
Každá dvojica požiadavka + odpoveď dostane correlation ID. Budúce debugovanie starej objednávky vám poďakuje.
Klienti citliví na rate limity
Rešpektujte zdokumentované rate limity. Klient, ktorý sa umiernene odťahuje späť, škáluje lepšie než ten, ktorý agresívne retryuje.
Človek v slučke
Chráňte prvý production call schválením človekom. Automatizáciu rozširujte až po overení stability integrácie.
Monitorovanie výdavkov
Upozornite, keď mesačné výdavky účtu smerujú k alebo pod €500. Strata API prístupu počas kampane bolí.
Najčastejšie otázky
Pre koho je BlogDrip API určené?
Pre účty inzerentov, ktoré chcú prepojiť svoj vlastný softvér — vlastný dashboard, platformu SEO agentúry, interné CRM — s objednávacím workflowom BlogDrip pre hosťujúce články. Typickými používateľmi sú agentúry spravujúce kampane vo veľkom, interné SEO tímy integrujúce sa so svojím stackom a vývojári budujúci operačné nástroje pre konkrétneho klienta alebo produkt.
Potrebujem na použitie API byť vývojár?
Na vytvorenie samotnej integrácie áno. API je programatické rozhranie — jeho používanie vyžaduje písanie kódu alebo spoluprácu s vývojárom. Ak chcete operačné výhody bez integračnej práce, UI trhoviska poskytuje rovnakú objednávaciu funkcionalitu manuálne.
Aké sú podmienky prístupu?
Aktívny BlogDrip účet, ktorý minie aspoň €500 mesačne v celkových výdavkoch — manuálne aj API objednávky sa započítavajú do prahu. API prístup sa automaticky deaktivuje, ak váš účet v danom mesiaci minie menej. €500 je prah objemu, nie samostatný poplatok za API.
Kde je dokumentácia API?
Oficiálna dokumentácia API je zverejnená na app.blogdrip.com/api/public/docs/index.html, s machine-readable OpenAPI špecifikáciou na app.blogdrip.com/api/public/openapi.json. Obe popisujú autentifikačný mechanizmus, kompletný katalóg endpointov pod namespace `/api/public/*`, tvary požiadaviek a odpovedí, formát paginácie a chybové odpovede. Považujte ich za zdroj pravdy pre vašu integráciu.
Kde nájdem svoje API poverenia?
V Moje nastavenia → Prístup k API na app.blogdrip.com/settings. Dostanete `x-client-id` a `x-client-secret`; obe idú do každej autorizovanej požiadavky ako HTTP hlavičky. Secret sa zobrazí raz pri vydaní alebo rotácii — ihneď ho skopírujte do secret managera, pretože neskôr ho nemožno získať. Poverenia sú viazané na účet; zaobchádzajte s nimi ako s akýmkoľvek iným tajomstvom a nedávajte ich do verzovacieho systému.
Ako funguje paginácia na list endpointoch?
List endpointy obalujú svoje odpovede v `{ data, pagination }` obálke a používajú 0-based paging — pre prvú stránku pošlite `?page=0`, pre druhú `?page=1` a podobne. Paginacný blok v odpovedi hovorí, či existujú ďalšie stránky. Ak migrujete z legacy rozhrania `/api/<path>`, tvar odpovede sa nemení — iba sa presúva base path na `/api/public/*`.
Podporuje API webhooks?
Skontrolujte OpenAPI spec na app.blogdrip.com/api/public/openapi.json pre aktuálny zoznam podporovaných mechanizmov callbackov alebo notifikácií udalostí. Ak funkcia nie je uvedená, budujte integráciu bez predpokladu jej existencie — polling API vo vlastnom režime je bezpečné záložné riešenie.
Existuje sandbox prostredie?
Autoritatívna odpoveď je v aktuálnej API dokumentácii. Ak je sandbox uvedený, použite ho na integračné testovanie. Ak nie je uvedený, nevytvárajte počas automatizovaného testovania reálne platené objednávky bez explicitného povolenia — namiesto toho použite vyhradenú testovaciu kampaň a človeka v slučke.
Môžu API objednávky použiť Instant Publishing?
Dostupnosť Instant Publishing závisí od toho, či vybraný web podporuje automatizovanú integráciu publikovania (buď BlogDrip WordPress plugin alebo Agency API pripojenie). Akýkoľvek objednávka — API alebo manuálna — umiestnená na oprávnenom webe môže využiť automatizované publikovanie. Nie každý web v trhovisku to podporuje, preto by mala vaša integrácia považovať čas publikovania za špecifický pre web, nie jednotný.
Aký je rozdiel medzi Advertiser API a Agency API?
Advertiser API je určené pre zákazníkov, ktorí chcú automatizovať objednávanie hosťujúcich článkov zo svojho vlastného softvéru. Agency API je pre externé agentúry, platformy na link building a siete vydavateľov, ktoré chcú prepojiť svoj inventár s BlogDrip a automatizovať podporované plnenie. Obe sú samostatné — používanie jedného nevyžaduje druhé.
Čo sa stane, ak retrynem zlyhanú požiadavku na vytvorenie objednávky?
Ak ste nevideli potvrdenú odpoveď, predpokladajte, že prvá požiadavka mohla na serveri uspieť. Neretryujte automaticky ne-idempotentné vytvorenie objednávky. Pridajte server-side de-duplication key alebo sa najprv spýtajte, či objednávka už nebola vytvorená — podľa toho, čo váš workflow podporuje čisto. Retry pri objednávke, ktorá úspešne prebehla, ale ktorú ste nevideli, spôsobí dvojité zúčtovanie.
Ste pripravení automatizovať budovanie odkazov?
Otvorte dokumentáciu API, vygenerujte svoje poverenia a začnite stavať. Trhovisko škáluje s vašou automatizáciou — nie naopak.