Ръководство за разработчици
Създайте собствен инструмент за автоматизация на изграждането на линкове с BlogDrip API
Свържете софтуера си директно с BlogDrip и автоматизирайте поръчките за гост публикации. Създавайте персонализирани SEO работни потоци, интегрирайте съществуващите приложения и управлявайте операциите по link building по-ефективно.
Защо да автоматизирате
Защо да създадете собствен инструмент за автоматизация на изграждането на линкове
SEO агенциите и вътрешните маркетинг екипи срещат една и съща оперативна закономерност: търсене на възможности за публикуване на ръка, повторно въвеждане на поръчки за гост публикации, управление на множество клиентски кампании, прехвърляне на информация между вътрешни системи, следене на напредъка на поръчките и опит за скалиране на всичко това без пропорционално увеличаване на броя на служителите.
API интеграция премахва повтарящата се механична работа от задълженията на екипа Ви и я прехвърля в код. Съществуващият Ви софтуер — CRM, инструмент за управление на кампании или персонализирано табло, в което екипът Ви работи — говори директно с маркетплейса. Операторите остават фокусирани върху стратегията, брифовете и контрола на качеството, вместо да въвеждат поръчки ръчно.
Автоматизацията дава ефективност на работните потоци, не подобрява директно SEO ранкинга. Тя няма да направи успешна лошо замислена кампания и няма да замени човешката преценка при избора на издатели. Това, което върши добре, е да премахне слоя за въвеждане на данни, така че когато решите какво да купите, да можете да го изпълните в какъвто обем желаете.
Какво можете да създадете
Какво можете да изградите с BlogDrip API
Практични модели за софтуер, изграден върху програматична интеграция с маркетплейса.
Персонализирано табло за гост публикации
Вътрешно приложение, което се свързва с BlogDrip и подава поддържани поръчки за гост публикации от UI, който Вашият екип контролира.
Система за управление на SEO агенция
Поръчването на гост публикации е вградено в съществуващия работен процес на агенцията, така че мениджърите по кампании никога не напускат системата, която вече ползват.
Автоматично подаване на поръчки
API заявки създават поддържани поръчки за гост публикации на партиди, без ръчното въвеждане на данни за всяка поръчка.
Управление на клиентски кампании
Свържете вътрешните записи за клиенти и кампании с workflow-а за поръчки в BlogDrip — единствен източник на истината за това кой купува какво.
Автоматизация на работни потоци
Задействайте поддържани API операции от вътрешни бизнес процеси — одобрения, стартове, планирани вълни от кампании.
Отчитане и мониторинг
Изтегляйте свързана с поръчките информация в персонализирани отчети, където е поддържано. Ограничете отчетите до това, което реално експонира API, вместо да предполагате пълна видимост в реално време.
Архитектура
Примерна архитектура за автоматизация
Здравословна интеграция разделя отговорностите в четири слоя.
На върха е външното Ви автоматизационно приложение — персонализирано табло, софтуер за SEO агенция, вътрешен CRM или система за управление на кампании. Там Вашият екип работи всекидневно.
Под него е бекендът на приложението Ви. Неговите отговорности са тези, които всяка интеграция трябва да изпълни правилно: съхраняване на `x-client-id` и `x-client-secret` сигурно, валидиране на входните данни преди да достигнат BlogDrip, подготвяне и изпращане на API заявки, обработка на `{ data, pagination }` отговори, логване на оперативни събития и управление на повторения безопасно, така че временен проблем с мрежата да не се превърне в дублирана платена поръчка.
След това заявките достигат Advertiser API на BlogDrip — публичния, версиониран слой под `/api/public/*` — който експонира поддържаната функционалност за поръчване на гост публикации.
API-то редиректва поръчките към маркетплейса на BlogDrip — над 275,000+ уебсайта в общия инвентар — и оттам в приложимия workflow за обработка на поръчки и публикуване. В зависимост от избрания уебсайт, публикуването може да бъде ръчно от страната на издателя или автоматизирано чрез WordPress плъгин или Agency API. Не всеки уебсайт в маркетплейса поддържа Незабавно публикуване, затова интеграцията Ви трябва да третира времето за публикуване като зависещо от workflow-а, а не като моментално.
Изградете инструмента за автоматизация — стъпка по стъпка
Осем стъпки от определяне на обхвата до мониторинг. Третирайте ги като справочник, а не като строга последователност — много от тях могат да се изпълняват паралелно.
Дефинирайте работния поток за автоматизация
Определете кои задачи да се автоматизират, каква информация трябва на приложението Ви, кога трябва да се подаде поръчка, как се предотвратяват дублирани поръчки, как се обработват грешките и как се съхраняват данните за кампаниите. Конкретен пример за обхват: агенция, управляваща 20 клиенти, всеки с по 3–5 активни кампании, иска новите кампании автоматично да генерират поръчки за кратък списък от предварително одобрени уебсайтове — но само след човешко одобрение на брифа за кампанията.
Получете достъп до BlogDrip API
Отворете профила си на app.blogdrip.com/settings и отидете в Моите настройки → API access, за да намерите своите креденшъли. Ще видите две стойности: `x-client-id` и `x-client-secret`. Секретът се показва веднъж при издаване или ротация — копирайте го незабавно в своя secret manager. Достъпът изисква минимум €500 на месец общи разходи по акаунта — ръчни поръчки и API поръчки се броят, двете заедно. Достъпът до API се деактивира автоматично, ако минимумът не е изпълнен за даден месец. €500 е праг на разход, а не отделна такса за абонамент за API.
Прочетете API документацията
Официалната документация на app.blogdrip.com/api/public/docs/index.html описва точните endpoints под namespace-а `/api/public/*`, автентикацията (двете двойки headers, споменати по-горе), методите на заявки, задължителните параметри, формати на отговорите (list endpoints обвиват отговорите в `{ data, pagination }` с 0-базирано `?page=0`), валидационните грешки (`{ message }`) и наличните операции за поръчване. Третирайте документацията като авторитетен източник: ако параметър не е документиран, не предполагайте, че съществува.
Изградете API връзката
Създайте бекенд на приложението, който съхранява и `x-client-id`, и `x-client-secret` сигурно (environment variables, secret manager — никога във frontend кода), изпраща автентикирани заявки с двата headers, парсва отговорите, обработва грешки и пише структурирани логове за всяко изходящо извикване. Дръжте API клиента като малък, добре тестван модул, така че останалата част от приложението да не комуникира директно с BlogDrip.
Реализирайте автоматизирано поръчване на гост публикации
Свържете вътрешния workflow с поддържаните операции за поръчване в BlogDrip. Типичен поток: в системата Ви се създава нова кампания → избира се уебсайт (резолвирайте неговия `marketSiteId` от endpoints-а на маркетплейса) → приложението Ви подготвя необходимата информация за поръчката (заглавие, URL, описание, `categoryId`, `marketSiteId`, `campaignId`, опционална `scheduleDate`, `linkNoFollow`) → бекендът валидира поръчката спрямо бизнес правилата Ви → приложението подава поръчката през Advertiser API → отговорът се съхранява във вашата система за проследимост. Валидирайте всяко поле спрямо OpenAPI спецификацията преди изпращане.
Обработвайте грешки и дублирани поръчки
Валидирайте заявките преди изпращане, предотвратете случайни дублирани поръчки (идемпотентен ключ или сървърно-странична проверка за дублиране е безопасен модел), логвайте всяка API неуспешна заявка с достатъчен контекст за по-късно отстраняване на грешки, обработвайте временно свързване грациозно и спазвайте документираните rate limits. Едно правило за запомняне: никога не правете автоматично повторение на неидемпотентна заявка за създаване на поръчка без изрично човешко или системно потвърждение — повторение на успешна поръчка, за която не сте видели отговора, създава двойно начисление.
Тествайте интеграцията си
Изпълнете интеграцията си срещу sandbox среда, ако такава е документирана. Ако няма наличен sandbox, тествайте внимателно в production — никога не пускайте автоматизирани тестови набори, които създават реални платени поръчки без изрично разрешение. Използвайте отделна тестова кампания с човешка рецензия преди първата автоматизирана поръчка и ограничете автоматизираните тестове до кратък allow-list от уебсайтове, които предварително сте одобрили за интеграционно тестване.
Деплой и мониторинг
Преместете креденшълите в production secret store, добавете мониторинг за интеграционни грешки и нетипични модели при подаване на поръчки, следете резултатите от подаването на поръчки end-to-end, пазете оперативните логове достатъчно дълго за отстраняване на инцидент на възраст две седмици, наблюдавайте разходите на акаунта, за да не загубите достъп до API при спада под €500 месечно минимум, и следете changelog-а на BlogDrip за API промени, които могат да изискват поддръжка на интеграцията.
Шаблони за интеграция
Как изглежда добре направена интеграция
Авторитетният източник за изпълними примери е OpenAPI спецификацията на app.blogdrip.com/api/public/openapi.json и човеко-четивната документация на /api/public/docs. Спецификацията е това, спрямо което кодът Ви трябва да бъде генериран или проверяван — не фрагмент от лендинг страница, който може да е остарял.
На практика чиста интеграция обикновено следва един и същ модел. Тънък API-клиент модул на предпочитания от Вас език — една обвиваща функция за всяка операция, от която се нуждаете — се занимава с механиката: задава `x-client-id` и `x-client-secret` headers на всяка заявка, сериализира тялото на заявката, десериализира `{ data, pagination }` обвивката на list endpoints (0-базирано пагиниране) и преобразува error отговорите (`{ message }`) в изключения, които бизнес логиката може чисто да прихване. Всяка обвивка трябва да има поне един тест, асертиращ върху документираната форма, така че промяна в схемата да се прояви като провалящ се тест преди да стигне до production. Само след като този модул е стабилен, го свързвате с останалата част от приложението — тригери на кампании, опашки за поръчки, retry работници, отчети.
Тази последователност прави интеграцията одитируема: API клиентът Ви е малка, добре тествана повърхност; всичко останало комуникира с BlogDrip през него.
Добри практики
Какво прави една API интеграция устойчива
Модели, които запазват автоматизираните системи здрави дълго след деня на пускане.
Идемпотентност по дизайн
Третирайте създаването на поръчки като скъпо и необратимо. Дедупликирайте от ваша страна преди заявката да излезе — никога след това.
Коректно управление на идентификационните данни
API креденшълите трябва да живеят в secret manager, засягащи се за всяка среда. Ротирайте ги при напускане, не при пробив.
Структурирано логиране
Всяка двойка заявка + отговор получава correlation ID. Бъдещият Ви аз, който дебъгва остаряла поръчка, ще благодари на настоящия Ви аз.
Клиенти, съобразени с лимитите за заявки
Спазвайте документираните rate limits. Клиент, който отстъпва чисто, ще скалира по-добре от такъв, който агресивно прави retry.
Човек в цикъла
Защитете първото production извикване с човешко одобрение. Разширявайте автоматизацията само след като интеграцията се докаже като стабилна.
Мониторинг на разходите
Сигнализирайте, когато месечните разходи на акаунта се приближават до или падат под €500. Загубата на достъп до API по средата на кампания е болезнена.
Често задавани въпроси
За кого е предназначен BlogDrip API?
Advertiser акаунти, които искат да свържат собствения си софтуер — персонализирано табло, платформа за SEO агенция, вътрешен CRM — към workflow-а за поръчки на гост публикации в BlogDrip. Типичните потребители са агенции, управляващи кампании в голям обем, вътрешни SEO екипи, които интегрират със съществуващ стек, и разработчици, изграждащи оперативни инструменти за конкретен клиент или продукт.
Трябва ли да съм разработчик, за да използвам API-то?
За да изградите самата интеграция — да. API е програматичен интерфейс — използването му изисква писане на код или работа с разработчик. Ако искате оперативните ползи без интеграционната работа, UI на маркетплейса покрива същата функционалност за поръчване ръчно.
Какви са изискванията за достъп?
Активен BlogDrip акаунт, който харчи поне €500 на месец общо — ръчни и API поръчки се броят към прага. Достъпът до API се деактивира автоматично, ако акаунтът харчи по-малко през даден месец. €500 е праг на обем, а не отделна такса за абонамент за API.
Къде е документацията за API-то?
Официалната API документация е публикувана на app.blogdrip.com/api/public/docs/index.html, а машинно-четимата OpenAPI спецификация е на app.blogdrip.com/api/public/openapi.json. И двете описват схемата за автентикация, пълния каталог от endpoints под namespace-а `/api/public/*`, формите на заявки и отговори, формата за пагинация и error отговорите. Третирайте ги като източник на истината за интеграцията Ви.
Къде мога да намеря моите API креденшъли?
В Моите настройки → API access на app.blogdrip.com/settings. Ще получите `x-client-id` и `x-client-secret`; и двете се подават във всяка автентикирана заявка като HTTP headers. Секретът се показва веднъж при издаване или ротация — копирайте го незабавно в secret manager, тъй като не може да бъде извлечен по-късно. Креденшълите са per-account; третирайте ги като всяка друга тайна и не ги слагайте в version control.
Как работи пагинацията при list endpoints?
List endpoints обвиват отговорите си в `{ data, pagination }` обвивка и използват 0-базирано пагиниране — подайте `?page=0` за първата страница, `?page=1` за втората и т.н. Блокът pagination в отговора Ви казва дали има още страници. Ако мигрирате от legacy интерфейса `/api/<path>`, формата на отговора остава същата — само базовият път се мести към `/api/public/*`.
Поддържа ли API-то webhooks?
Проверете OpenAPI спецификацията на app.blogdrip.com/api/public/openapi.json за текущия списък с поддържани callback или механизми за уведомяване за събития. Ако функцията не е изброена, изградете интеграцията си, без да приемате, че съществува — полингът на API-то по ваш собствен график е безопасен резервен план.
Има ли sandbox среда?
Авторитетният отговор е в текущата API документация. Ако е посочен sandbox, използвайте го за интеграционно тестване. Ако не е посочен, не създавайте реални платени поръчки по време на автоматизирани тестове без изрично разрешение — използвайте отделна тестова кампания и човешка рецензия вместо това.
Могат ли API поръчките да използват Незабавно публикуване?
Наличността на Незабавно публикуване зависи от това дали избраният уебсайт има поддържана автоматизирана интеграция за публикуване (или чрез WordPress плъгин на BlogDrip, или чрез Agency API връзка). Всяка поръчка — API или ръчна — поставена на допустим уебсайт може да се възползва от автоматизирано публикуване. Не всеки уебсайт в маркетплейса го поддържа, така че интеграцията Ви трябва да третира времето за публикуване като специфично за всеки уебсайт, а не универсално.
Каква е разликата между Advertiser API и Agency API?
Advertiser API е за клиенти, които искат да автоматизират поръчването на гост публикации от собствения си софтуер. Agency API е за външни агенции, платформи за link building и мрежи от издатели, които искат да свържат собственото си инвентар с BlogDrip и да автоматизират поддържаното изпълнение. И двете са самостоятелни — използването на едното не изисква другото.
Какво се случва, ако повторя неуспешна заявка за създаване на поръчка?
Ако не сте видели потвърден отговор, приемете, че първата заявка може да е успяла на сървърната страна. Не правете автоматично повторение на неидемпотентно създаване на поръчка. Добавете сървърно-страничен ключ за дедупликация или направете заявка за евентуално създадената поръчка преди повторение — което и да е по-подходящо за вашия workflow. Повторение върху поръчка, която е била успешна, но чиито отговор не сте видели, създава двойно начисление.
Готови ли сте да автоматизирате изграждането на линкове?
Отворете API документацията, генерирайте своите идентификационни данни и започнете да изграждате. Маркетплейсът се скалира с вашата автоматизация — не обратното.