Průvodce pro vývojáře
Vytvořte si nástroj pro automatizaci budování odkazů s BlogDrip API
Propojte svůj software přímo s BlogDrip a automatizujte zadávání objednávek hostovaných článků. Vytvořte vlastní SEO workflowy, integrujte stávající aplikace a efektivněji řiďte procesy budování odkazů.
Proč automatizovat
Proč si vytvořit vlastní nástroj pro automatizaci budování odkazů
SEO agentury i interní marketingové týmy narážejí na stejný operační vzorec: ruční vyhledávání možností publikace, opětovné zadávání objednávek hostovaných článků, správa více klientských kampaní, přenos informací mezi interními systémy, sledování postupu objednávek a snaha škálovat vše bez úměrného nárůstu počtu zaměstnanců.
Integrace přes API odstraní opakující se mechanickou práci z povinností vašeho týmu a přesměruje ji do kódu. Váš stávající software — CRM, nástroj pro řízení kampaní nebo vlastní dashboard, ve kterém váš tým pracuje — komunikuje přímo s tržištěm. Operátoři se mohou soustředit na strategii, zadání a kontrolu kvality místo ručního zadávání objednávek.
Automatizace přináší efektivitu pracovních postupů, ne záruku lepších SEO výsledků. Nedokáže zachránit špatnou kampaň a nenahradí lidský úsudek při výběru vydavatelů. Dobře provedená automatizace ale odstraní vrstvu zadávání dat, takže když rozhodnete, co koupit, můžete to provést v libovolném objemu.
Co můžete vytvořit
Co lze postavit pomocí BlogDrip API
Praktické vzory pro software postavené na programové integraci s tržištěm.
Vlastní panel pro hostované články
Interní aplikace, která se připojí k BlogDrip a z UI, které ovládá váš tým, podává podporované objednávky hostovaných článků.
Systém řízení pro SEO agentury
Objednávání hostovaných článků zapojené do stávajícího agency workflow, takže manažeři kampaní nikdy nemusí opouštět systém, který už používají.
Automatické odesílání objednávek
API požadavky hromadně vytvoří podporované objednávky hostovaných článků, bez potřeby manuálního zadávání pro každou objednávku.
Řízení klientských kampaní
Propojte interní záznamy klientů a kampaní s objednávacími procesy BlogDrip — jedno zdrojové místo pravdy pro to, kdo co kupuje.
Automatizace workflowů
Spouštějte podporované API operace z interních obchodních procesů — schválení, spuštění kampaně, plánované vlny kampaní.
Reporting a monitoring
Tahleťte informace o objednávkách do vlastních reportingových nástrojů tam, kde to API podporuje. Omezte reportování na to, co API skutečně vystavuje, místo aby jste předpokládali kompletní real-time přehled.
Architektura
Příklad architektury automatizace
Zdravá integrace odděluje zodpovědnosti napříč čtyřmi vrstvami.
Nahoře je vaše externí automatizační aplikace — vlastní dashboard, software SEO agentury, interní CRM nebo systém řízení kampaní. Tady váš tým pracuje denně.
Pod tím je backend vaší aplikace. Jeho povinnosti jsou ty, které musí každá integrace správně řešit: bezpečně uložit `x-client-id` a `x-client-secret`, validovat vstupy dříve, než vůbec dorazí do BlogDrip, připravovat a odesílat API požadavky, zpracovávat odpovědi ve tvaru `{ data, pagination }`, logovat provozní události a bezpečně řídit retry logiku, aby přechodná síťová závada nepřevznikla v duplicitní placenou objednávku.
Odtud požadavky zasáhnou BlogDrip Advertiser API — veřejné, verzované rozhraní pod `/api/public/*` — které vystavuje podporované funkce objednávání hostovaných článků.
API směruje objednávky do tržiště BlogDrip — více než 275,000+ webů v dostupném inventáři — a odtud do příslušného zpracování objednávky a workflowu publikace. V závislosti na vybraném webu může být publikace na straně vydavatele manuální nebo automatizovaná přes zásuvný modul WordPress či API pro agentury. Ne každý web na tržišti podporuje Okamžité publikování, proto by vaše integrace měla považovat načasování publikace za závislé na workflow, nikoli za okamžité.
Postavte svůj nástroj pro automatizaci krok za krokem
Osm kroků od definice až po monitoring. Berte je jako referenci, ne striktní posloupnost — mnoho kroků probíhá paralelně.
Definujte svůj automatizační workflow
Určete, které úkoly mají být automatizovány, jaké informace vaše aplikace potřebuje, kdy by měla být objednávka odeslána, jak zabráníte duplicitním objednávkám, jak se řeší chyby a jak se ukládají data kampaní. Konkrétní příklad rozsahu: agentura spravující 20 klientů, každý s 3–5 aktivními kampaněmi, chce, aby nové kampaně automaticky generovaly objednávky pro předvybraný seznam schválených webů — ale teprve poté, co člověk schválí brief kampaně.
Získejte přístup k BlogDrip API
Otevřete svůj účet na app.blogdrip.com/settings a přejděte do Moje nastavení → Přístup k API, kde najdete své přihlašovací údaje. Uvidíte dvě hodnoty: `x-client-id` a `x-client-secret`. Secret se zobrazí pouze jednou při vydání nebo otáčení, proto jej ihned zkopírujte do svého správce tajemství. Přístup vyžaduje minimální měsíční utrácení ve výši €500 celkem na účtu — manuální i API objednávky se počítají dohromady. API přístup se automaticky deaktivuje, pokud minimální výdaj v daném měsíci není splněn. €500 je práh utrácení, nikoli samostatný poplatek za API.
Přečtěte si dokumentaci API
Oficiální dokumentace na app.blogdrip.com/api/public/docs/index.html popisuje přesné endpointy v rámci `/api/public/*`, autentizaci (dva hlavičkové páry zmíněné výše), metody požadavků, povinné parametry, formáty odpovědí (list endpointy obalují odpovědi do `{ data, pagination }` s 0-based `?page=0`), validační chyby (`{ message }`) a dostupné ordering operace. Považujte dokumentaci za autoritativní zdroj: pokud parametr není zdokumentovaný, nepředpokládejte, že existuje.
Vybudujte API připojení
Vytvořte backend aplikace, který bezpečně uloží `x-client-id` i `x-client-secret` (proměnné prostředí, správce tajemství — nikdy ve frontendu), odešle autentizované požadavky s oběma hlavičkami, parsuje odpovědi, zpracovává chyby a zapisuje strukturované logy pro každý odchozí volání. Udržte API klienta jako malý, dobře otestovaný modul, aby zbytek aplikace nikdy nemluvil s BlogDrip přímo.
Implementujte automatické zadávání objednávek hostovaných článků
Propojte svůj interní workflow s podporovanými ordering operacemi BlogDrip. Typický tok: v systému je vytvořena nová kampaň → vybere se web (vyřešte jeho `marketSiteId` z endpoints tržiště) → vaše aplikace připraví požadované informace pro objednávku (titul, URL, popis, `categoryId`, `marketSiteId`, `campaignId`, volitelně `scheduleDate`, `linkNoFollow`) → backend validuje objednávku proti obchodním pravidlům → aplikace odešle objednávku přes Advertiser API → odpověď se uloží ve vašem systému pro sledovatelnost. Validujte každé pole proti OpenAPI spec dříve, než jej odešlete.
Řešte chyby a duplicitní objednávky
Validujte požadavky před odesláním, zabráníte náhodným duplicitám (idempotency klíč nebo serverová deduplikace na vaší straně je bezpečný vzor), logujte každé selhání API s dostatečným kontextem pro budoucí debug, elegantně řešte dočasné problémy s konektivitou a dodržujte dokumentované rate limity. Jedno pravidlo k internalizaci: nikdy automaticky neopakujte ne-idempotentní požadavek na vytvoření objednávky bez explicitního potvrzení člověkem nebo systémem — opakování u objednávky, u které jste neobdrželi odpověď, může vytvořit dvojí účtování.
Otestujte integraci
Spusťte integraci proti sandbox prostředí, pokud je v dokumentaci uvedeno. Pokud sandbox není dostupný, testujte proti produkci opatrně — nikdy nespouštějte automatizované testy, které vytvářejí skutečné placené objednávky bez explicitního povolení. Použijte vyhrazenou testovací kampaň s lidským schválením před první automatizovanou objednávkou a omeňte automatizované testy na krátký allow-list webů, které jste předem schválili pro integrační testování.
Nasazení a monitoring
Přesuňte přihlašovací údaje do produkčního správce tajemství, přidejte monitoring selhání integrace a neobvyklých vzorců odesílání objednávek, sledujte výsledky odesílání objednávek end-to-end, uchovávejte provozní logy dostatečně dlouho pro debug dvoutýdenního incidentu, sledujte výdaje na účtu, aby vám nevypnuli API přístup při poklesu pod €500 měsíčně, a sledujte changelog BlogDrip pro aktualizace API, které mohou vyžadovat údržbu integrace.
Vzory integrace
Jak vypadá zdravá integrace
Autoritativním zdrojem pro spustitelné příklady je OpenAPI specifikace na app.blogdrip.com/api/public/openapi.json a čitelná dokumentace na /api/public/docs. Specifikace je to, proti čemu by měl být váš kód generován nebo ověřován — ne landing-page snippet, který může zastarat.
V praxi čistá integrace obvykle následuje stejný tvar. Tenký API-klient v preferovaném jazyce — jedna obalová funkce na každou potřebnou operaci — řeší mechaniku: nastaví hlavičky `x-client-id` a `x-client-secret` na každém požadavku, serializuje tělo požadavku, deserializuje obálku `{ data, pagination }` na list endpointy (0-based stránkování) a převádí chybové odpovědi (`{ message }`) na výjimky, které může vaše obchodní logika čistě zachytit. Každý wrapper má alespoň jeden test ověřující zdokumentovaný tvar, takže změna schématu se projeví jako selhávající test dříve, než se dostane do produkce. Až je ten modul stabilní, zapojíte jej do zbytku aplikace — spouštěče kampaní, fronty objednávek, retry workerů, reporting.
Tento postup udržuje integraci auditovatelnou: váš API klient je malá, dobře otestovaná plocha; vše ostatní s BlogDrip komunikuje přes něj.
Doporučené postupy
Co dělá API integraci dlouhodobě udržitelnou
Vzorové postupy, které udrží automatizované systémy zdravé dlouho po spuštění.
Idempotence v návrhu
Považujte vytvoření objednávky za nákladné a nevratné. Deduplikujte na své straně před odesláním požadavku — nikdy až po.
Péče o přístupové údaje
API přihlašovací údaje patří do správce tajemství, scopeované per prostředí. Otáčejte je při odchodu, ne až po úniku.
Strukturované logování
Každá dvojice požadavek + odpověď dostane korelační ID. Budoucí vy debugující starou objednávku vám poděkuje.
Klienti respektující limity
Respektujte dokumentované rate limity. Klient, který se čistě ustupuje při limitu, škáluje lépe než ten, který agresivně retryuje.
Člověk v rozhodovací smyčce
Zakryjte první produkční volání lidským schválením. Rozšiřujte automatizaci až poté, co se integrace osvědčí jako stabilní.
Sledování výdajů
Upozorněte, když měsíční utrácení směřuje k nebo pod €500. Ztráta API přístupu uprostřed kampaně bolí.
Často kladené dotazy
Pro koho je BlogDrip API určeno?
Účty inzerentů, které chtějí propojit vlastní software — vlastní dashboard, platformu SEO agentury nebo interní CRM — s objednávacím workflowem hostovaných článků BlogDrip. Typičtí uživatelé jsou agentury spravující kampaně ve velkém, interní SEO týmy integrující se do stávajícího stacku a vývojáři budující provozní nástroje pro konkrétního klienta nebo produkt.
Musím být vývojář, abych použil API?
Pro samotné vybudování integrace ano. API je programové rozhraní — jeho použití vyžaduje psaní kódu nebo spolupráci s vývojářem. Pokud chcete provozní přínosy bez integrační práce, UI tržiště pokrývá stejnou objednávací funkcionalitu manuálně.
Jaké jsou požadavky na přístup?
Aktivní účet BlogDrip, který utrácí alespoň €500 měsíčně celkem — manuální i API objednávky se započítávají do prahu. API přístup se automaticky deaktivuje, pokud váš účet v daném měsíci utratí méně. €500 je objemový práh, nikoli samostatný poplatek za API.
Kde najdu dokumentaci k API?
Oficiální dokumentace API je publikovaná na app.blogdrip.com/api/public/docs/index.html, se strojově čitelnou OpenAPI specifikací na app.blogdrip.com/api/public/openapi.json. Oba zdroje popisují autentizační schéma, kompletní katalog endpointů v rámci `/api/public/*`, tvary požadavků a odpovědí, formát stránkování a chybové odpovědi. Považujte je za zdroj pravdy pro vaši integraci.
Kde najdu své API přihlašovací údaje?
V Moje nastavení → Přístup k API na app.blogdrip.com/settings. Dostanete `x-client-id` a `x-client-secret`; obojí jde do každého autentizovaného požadavku jako HTTP hlavičky. Secret se zobrazí pouze jednou při vydání nebo otáčení — ihned jej zkopírujte do správce tajemství, protože později ho nelze získat zpět. Přihlašovací údaje jsou vázané na účet; zacházejte s nimi jako s jinými tajnostmi a neukládejte je do verzovacího systému.
Jak funguje stránkování na list endpointy?
List endpointy obalují své odpovědi do `{ data, pagination }` a používají 0-based stránkování — pro první stránku pošlete `?page=0`, pro druhou `?page=1` atd. Blok pagination v odpovědi vám řekne, zda existují další stránky. Pokud migrujete ze starého rozhraní `/api/<path>`, tvar odpovědi zůstává stejný — pouze základní cesta se přesunula na `/api/public/*`.
Podporuje API webhooky?
Zkontrolujte OpenAPI spec na app.blogdrip.com/api/public/openapi.json pro aktuální seznam podporovaných callback nebo event-notifikačních mechanismů. Pokud funkce není uvedená, postavte integraci bez předpokladu její existence — polling API ve vašem vlastním harmonogramu je bezpečná fallback možnost.
Existuje sandbox prostředí?
Autoritativní odpověď najdete v aktuální dokumentaci API. Pokud je sandbox uvedený, použijte jej pro integrační testování. Pokud není uveden, nevytvářejte během automatizovaného testování skutečné placené objednávky bez explicitního povolení — místo toho použijte vyhrazenou testovací kampaň s lidským schválením.
Mohou API objednávky využít Okamžité publikování?
Dostupnost Okamžitého publikování závisí na tom, zda vybraný web podporuje automatizovanou publikaci (buď zásuvný modul BlogDrip pro WordPress, nebo propojení přes API pro agentury). Jakákoli objednávka — API nebo manuální — na způsobilém webu může být automaticky publikována. Ne každý web na tržišti to podporuje, proto by vaše integrace měla považovat načasování publikace za závislé na konkrétním webu.
V čem se liší Advertiser API a Agency API?
Advertiser API je určeno zákazníkům, kteří chtějí automatizovat objednávání hostovaných článků ze svého vlastního softwaru. API pro agentury je určeno externím agenturám, platformám pro budování odkazů a vydavatelské sítě, které chtějí připojit vlastní inventory k BlogDrip a automatizovat podporované plnění. Obě rozhraní jsou samostatná — použití jednoho nevyžaduje druhé.
Co se stane, když zopakuji neúspěšný požadavek na vytvoření objednávky?
Pokud jste neviděli potvrzenou odpověď, předpokládejte, že první požadavek mohl na serveru uspět. Neopravujte automaticky ne-idempotentní vytvoření objednávky. Přidejte serverovou deduplikaci, nebo před opakováním dotazujte, zda se možná vytvořená objednávka již nevyskytuje — podle toho, co váš workflow čistě podporuje. Opakování u úspěšné, ale neviděné objednávky vytvoří dvojí účtování.
Jste připraveni automatizovat budování odkazů?
Otevřete dokumentaci API, vygenerujte přihlašovací údaje a začněte stavět. Tržiště škáluje s vaší automatizací — ne naopak.