Przewodnik dla deweloperów
Stwórz narzędzie do automatyzacji budowania linków z BlogDrip API
Połącz swoje oprogramowanie bezpośrednio z BlogDrip i zautomatyzuj zamawianie wpisów gościnnych. Zbuduj niestandardowe workflow SEO, zintegruj istniejące aplikacje i sprawniej zarządzaj operacjami budowania linków.
Dlaczego automatyzować
Dlaczego warto stworzyć własne narzędzie do automatyzacji budowania linków
Agencje SEO i zespoły marketingowe wewnątrz firm napotykają ten sam schemat operacyjny: ręczne wyszukiwanie możliwości publikacji, ponowne wprowadzanie zamówień wpisów gościnnych, żonglowanie wieloma kampaniami klientów, przenoszenie danych między systemami wewnętrznymi, monitorowanie postępu zamówień i próby skalowania tego wszystkiego bez proporcjonalnego zwiększania zatrudnienia.
Integracja przez API zabiera zespołowi powtarzalną, mechaniczną pracę i kieruje ją przez kod. Państwa istniejące oprogramowanie — CRM, narzędzie do zarządzania kampaniami lub niestandardowy panel, w którym zespół pracuje na co dzień — komunikuje się bezpośrednio z marketplace. Operatorzy skupiają się na strategii, briefach i kontroli jakości zamiast na ręcznym wprowadzaniu zamówień.
Automatyzacja daje wydajność workflow, nie gwarantuje pozycji w wynikach wyszukiwania. Nie sprawi, że zła kampania nagle odniesie sukces, i nie zastąpi ludzkiego osądu przy wyborze wydawców. Natomiast skutecznie eliminuje warstwę wprowadzania danych, dzięki czemu gdy zdecydują Państwo, co kupić, można to wykonać w dowolnej skali.
Co można zbudować
Co można zbudować z wykorzystaniem BlogDrip API
Praktyczne wzorce dla oprogramowania opartego na programowej integracji z marketplace.
Niestandardowy panel wpisów gościnnych
Aplikacja wewnętrzna łącząca się z BlogDrip i składająca obsługiwane zamówienia wpisów gościnnych z poziomu interfejsu, którym Państwo zarządzają.
System zarządzania agencją SEO
Zamawianie wpisów gościnnych wpięte w istniejący workflow agencji, dzięki czemu kierownik kampanii nie opuszcza używanego już systemu.
Automatyczne wysyłanie zamówień
Żądania API tworzą obsługiwane zamówienia wpisów gościnnych w partiach, bez ręcznego wprowadzania danych dla każdego zamówienia.
Zarządzanie kampaniami klientów
Łączcie Państwo wewnętrzne rekordy klientów i kampanii z procesami zamawiania w BlogDrip — jedno źródło prawdy o tym, kto i co kupuje.
Automatyzacja procesów
Wywołuj obsługiwane operacje API z wewnętrznych procesów biznesowych — akceptacje, uruchomienia, zaplanowane fale kampanii.
Raportowanie i monitorowanie
Pobieraj informacje związane z zamówieniami do własnych narzędzi raportowych tam, gdzie jest to obsługiwane. Ogranicz raportowanie do danych udostępnianych przez API, zamiast zakładać pełną widoczność w czasie rzeczywistym.
Architektura
Przykładowa architektura automatyzacji
Zdrowa integracja rozdziela odpowiedzialności na cztery warstwy.
Na górze znajduje się zewnętrzna aplikacja automatyzująca — niestandardowy panel, oprogramowanie agencji SEO, wewnętrzny CRM lub system zarządzania kampaniami. To tutaj Państwa zespół pracuje na co dzień.
Poniżej leży backend aplikacji. Jego obowiązki to to, co każda integracja powinna zrobić poprawnie: bezpieczne przechowywanie `x-client-id` i `x-client-secret`, walidacja danych zanim trafią do BlogDrip, przygotowanie i wysyłka żądań API, obsługa odpowiedzi `{ data, pagination }`, logowanie zdarzeń operacyjnych oraz bezpieczne zarządzanie ponownymi próbami, żeby krótkotrwały błąd sieciowy nie zamienił się w zdublowane płatne zamówienie.
Następnie żądania trafiają do BlogDrip Advertiser API — publicznego, wersjonowanego interfejsu pod `/api/public/*`, który udostępnia funkcjonalność składania zamówień wpisów gościnnych.
API kieruje zamówienia do marketplace BlogDrip — ponad 275,000+ stron w ogólnej ofercie — a stamtąd do odpowiednich procesów przetwarzania zamówień i publikacji. W zależności od wybranej strony publikacja może być po stronie wydawcy ręczna albo zautomatyzowana przez wtyczkę WordPress lub Agency API. Nie każda strona na marketplace obsługuje publikację natychmiastową, dlatego integracja powinna traktować czas publikacji jako zależny od workflow, a nie natychmiastowy.
Stwórz narzędzie automatyzujące — krok po kroku
Osiem etapów od zakresu do monitoringu. Traktuj je jako punkt odniesienia, nie sztywną sekwencję — wiele z nich można uruchamiać równolegle.
Zdefiniuj workflow automatyzacji
Określ, które zadania mają być zautomatyzowane, jakie informacje potrzebuje Państwa aplikacja, kiedy zamówienie powinno zostać złożone, jak zapobiegać zdublowanym zamówieniom, jak obsługiwać błędy i jak przechowywane będą dane kampanii. Konkretne przykładowe określenie zakresu: agencja obsługująca 20 klientów, każdy z 3–5 aktywnymi kampaniami, chce aby nowe kampanie automatycznie generowały zamówienia dla krótkiej listy wcześniej zatwierdzonych stron — ale dopiero po ręcznej akceptacji briefu kampanii.
Uzyskaj dostęp do BlogDrip API
Zaloguj się na konto pod adresem app.blogdrip.com/settings i przejdź do Moje ustawienia → Dostęp do API, aby znaleźć poświadczenia. Zobaczysz dwie wartości: `x-client-id` oraz `x-client-secret`. Sekret jest wyświetlany tylko raz przy wydaniu lub rotacji, więc skopiuj go natychmiast do menedżera sekretów. Dostęp wymaga minimalnych wydatków na poziomie €500 miesięcznie dla całego konta — liczą się zarówno zamówienia ręczne, jak i przez API. Dostęp do API jest dezaktywowany automatycznie, jeśli próg nie zostanie spełniony w danym miesiącu. Kwota €500 to próg wydatków, a nie oddzielna opłata subskrypcyjna za API.
Przeczytaj dokumentację API
Oficjalna dokumentacja pod adresem app.blogdrip.com/api/public/docs/index.html opisuje dokładne endpointy pod przestrzenią nazw `/api/public/*`, uwierzytelnianie (wspomniane dwie pary nagłówków), metody żądań, wymagane parametry, formaty odpowiedzi (endpointy listujące zwracają odpowiedź opakowaną w `{ data, pagination }` z numeracją stron 0-based `?page=0`), błędy walidacji (`{ message }`) oraz dostępne operacje składania zamówień. Traktuj dokumentację jako źródło prawdy: jeśli parametr nie jest w niej udokumentowany, nie zakładaj, że istnieje.
Zbuduj połączenie z API
Stwórz backend aplikacji, który bezpiecznie przechowuje zarówno `x-client-id`, jak i `x-client-secret` (zmienne środowiskowe, menedżer sekretów — nigdy w kodzie frontendowym), wysyła uwierzytelnione żądania z oboma nagłówkami, parsuje odpowiedzi, obsługuje błędy i zapisuje strukturalne logi dla każdego wywołania. Trzymaj klienta API jako mały, dobrze przetestowany moduł, aby reszta aplikacji nigdy nie komunikowała się z BlogDrip bezpośrednio.
Wdrożenie automatycznego składania zamówień wpisów gościnnych
Połącz wewnętrzny workflow z obsługiwanymi operacjami składania zamówień w BlogDrip. Typowy przebieg: nowa kampania jest utworzona w Państwa systemie → wybierana jest strona (rozwiąż jej `marketSiteId` z endpointów marketplace) → aplikacja przygotowuje wymagane informacje zamówienia (tytuł, URL, opis, `categoryId`, `marketSiteId`, `campaignId`, opcjonalnie `scheduleDate`, `linkNoFollow`) → backend waliduje zamówienie względem reguł biznesowych → aplikacja składa zamówienie przez Advertiser API → odpowiedź jest zapisywana w Państwa systemie dla celów śledzenia. Waliduj każde pole zgodnie ze specyfikacją OpenAPI przed wysyłką.
Obsłuż błędy i zdublowane zamówienia
Waliduj żądania przed wysłaniem, zapobiegaj przypadkowemu duplikowaniu zamówień (bezpieczny wzorzec to klucz idempotencji lub serwerowa kontrola de-duplikacji), loguj każdą awarię API z wystarczającym kontekstem do późniejszego debugowania, obsługuj tymczasowe problemy z łącznością łagodnie oraz respektuj udokumentowane limity żądań. Zasada do zapamiętania: nigdy automatycznie nie ponawiaj nie-idempotentnego żądania tworzenia zamówienia bez wyraźnego potwierdzenia człowieka lub systemu — ponowienie po udanym, lecz niewidocznym dla Państwa żądaniu stworzy podwójne obciążenie.
Przetestuj integrację
Uruchom integrację przeciwko środowisku sandbox, jeśli jest ono udokumentowane. Jeśli sandbox nie jest dostępny, testuj na produkcji ostrożnie — nigdy nie uruchamiaj zautomatyzowanych testów tworzących rzeczywiste płatne zamówienia bez wyraźnej autoryzacji. Użyj dedykowanej kampanii testowej z człowiekiem w pętli weryfikującym pierwsze automatyczne zamówienie i ogranicz zautomatyzowane testy do krótkiej allow-listy stron, które wstępnie zatwierdziliście do testów integracyjnych.
Wdróż i monitoruj
Przenieś poświadczenia do produkcyjnego magazynu sekretów, dodaj monitoring awarii integracji i nietypowych wzorców wysyłania zamówień, śledź wyniki składania zamówień end-to-end, przechowuj logi operacyjne wystarczająco długo, by rozebrać incydent sprzed dwóch tygodni, monitoruj wydatki konta, aby nie stracić dostępu do API przez spadek poniżej €500 miesięcznie, oraz obserwuj changelog BlogDrip pod kątem aktualizacji API wymagających prac integracyjnych.
Wzorce integracji
Jak wygląda poprawna integracja
Autorytatywnym źródłem przykładów wykonywalnych jest specyfikacja OpenAPI pod adresem app.blogdrip.com/api/public/openapi.json oraz czytelna dokumentacja pod /api/public/docs. To specyfikacja powinna być podstawą do generowania lub weryfikacji kodu — nie fragmenty ze strony marketingowej, które mogą się zestarzeć.
W praktyce czysta integracja ma zwykle podobną strukturę. Cienki moduł klienta API w preferowanym języku — jedna funkcja-wrappper na potrzebną operację — obsługuje mechanikę: ustawia nagłówki `x-client-id` i `x-client-secret` na każdym żądaniu, serializuje ciało żądania, deserializuje kopertę `{ data, pagination }` na endpointach listujących (paginacja 0-based) i konwertuje odpowiedzi o błędach (`{ message }`) na wyjątki, które logika biznesowa może poprawnie złapać. Każdy wrapper powinien mieć przynajmniej jeden test asercji kształtu udokumentowanego w specyfikacji, aby zmiana schematu ujawniła się jako niepowodzenie testu zanim trafi na produkcję. Dopiero gdy ten moduł jest stabilny, podłączamy go do reszty aplikacji — triggerów kampanii, kolejek zamówień, workerów ponownie próbujących, raportowania.
Taki podział utrzymuje integrację audytowalną: klient API jest małą, dobrze przetestowaną powierzchnią; wszystko inne komunikuje się z BlogDrip przez niego.
Dobre praktyki
Co sprawia, że integracja API przetrwa
Wzorce, które utrzymują systemy zautomatyzowane w dobrej kondycji długo po dniu wdrożenia.
Idempotencja z założenia
Traktuj tworzenie zamówienia jako kosztowną i nieodwracalną operację. Deduplicuj po swojej stronie zanim żądanie zostanie wysłane — nigdy po.
Higiena poświadczeń
Poświadczenia API przechowuj w menedżerze sekretów, z podziałem na środowiska. Rotuj je przy odejściu pracownika, nie tylko przy incydencie.
Strukturalne logowanie
Każdej parze żądanie + odpowiedź przypisz ID korelacji. Przyszłe debugowanie starego zamówienia podziękuje obecnemu Tobie.
Klienci świadomi limitów
Respektuj udokumentowane limity żądań. Klient, który ładnie cofa się przy ograniczeniach, skaluje się lepiej niż ten, który agresywnie powtarza próby.
Człowiek w pętli
Zabezpiecz pierwsze produkcyjne wywołanie aprobatą człowieka. Rozszerzaj automatyzację dopiero po dowodzie stabilności integracji.
Monitorowanie wydatków
Wyślij alerty, gdy miesięczne wydatki konta zbliżają się do lub spadają poniżej €500. Utrata dostępu do API w połowie kampanii jest bolesna.
Najczęściej zadawane pytania
Dla kogo jest BlogDrip API?
Dla kont reklamodawców, które chcą połączyć własne oprogramowanie — niestandardowy panel, platformę agencji SEO lub wewnętrzny CRM — z workflow składania zamówień wpisów gościnnych w BlogDrip. Typowi użytkownicy to agencje obsługujące kampanie w dużej skali, zespoły SEO wewnątrz firm integrujące się z istniejącym stackiem oraz programiści budujący narzędzia operacyjne dla konkretnego klienta lub produktu.
Czy muszę być programistą, żeby korzystać z API?
Aby zbudować samą integrację — tak. API to interfejs programowy — jego użycie wymaga pisania kodu lub współpracy z deweloperem. Jeśli chcą Państwo korzyści operacyjne bez pracy integracyjnej, interfejs marketplace umożliwia ręczne wykonywanie tych samych operacji.
Jakie są wymagania dostępu?
Aktywne konto BlogDrip, które wydaje co najmniej €500 miesięcznie w sumie — liczą się zarówno zamówienia ręczne, jak i przez API. Dostęp do API jest dezaktywowany automatycznie, jeśli konto wyda mniej w danym miesiącu. Kwota €500 to próg wolumenu, a nie oddzielna opłata subskrypcyjna za API.
Gdzie jest dokumentacja API?
Oficjalna dokumentacja API jest opublikowana pod adresem app.blogdrip.com/api/public/docs/index.html, a maszynowo-czytelna specyfikacja OpenAPI znajduje się pod app.blogdrip.com/api/public/openapi.json. Oba źródła opisują schemat uwierzytelniania, pełny katalog endpointów w przestrzeni `/api/public/*`, kształty żądań i odpowiedzi, format paginacji oraz odpowiedzi błędów. Traktuj je jako źródło prawdy dla integracji.
Gdzie znajdę moje poświadczenia API?
W Moje ustawienia → Dostęp do API pod adresem app.blogdrip.com/settings. Otrzymają Państwo `x-client-id` oraz `x-client-secret`; obie wartości muszą iść w każdym uwierzytelnionym żądaniu jako nagłówki HTTP. Sekret jest wyświetlany jednorazowo przy wydaniu lub rotacji — skopiuj go natychmiast do menedżera sekretów, ponieważ nie można go później odzyskać. Poświadczenia są przypisane do konta; traktuj je jak inne sekrety i trzymaj poza kontrolą wersji.
Jak działa paginacja na endpointach listujących?
Endpointy listujące opakowują odpowiedzi w kopertę `{ data, pagination }` i używają paginacji 0-based — przekaż `?page=0` dla pierwszej strony, `?page=1` dla drugiej itd. Blok pagination w odpowiedzi informuje, czy istnieją kolejne strony. Jeśli migracja odbywa się z legacy interfejsu `/api/<path>`, kształt odpowiedzi pozostaje niezmieniony — jedynie ścieżka bazowa przenosi się do `/api/public/*`.
Czy API obsługuje webhooks?
Sprawdź specyfikację OpenAPI pod adresem app.blogdrip.com/api/public/openapi.json, aby zobaczyć aktualną listę obsługiwanych mechanizmów callback lub powiadomień o zdarzeniach. Jeśli funkcja nie jest wymieniona, buduj integrację nie zakładając jej istnienia — pollowanie API we własnym harmonogramie to bezpieczny fallback.
Czy jest środowisko sandbox?
Ostateczna odpowiedź znajduje się w bieżącej dokumentacji API. Jeśli sandbox jest wymieniony, użyj go do testów integracyjnych. Jeśli nie ma go w dokumentacji, nie twórz rzeczywistych płatnych zamówień podczas zautomatyzowanych testów bez wyraźnej autoryzacji — zamiast tego użyj dedykowanej kampanii testowej i weryfikacji człowieka w pętli.
Czy zamówienia przez API mogą korzystać z publikacji natychmiastowej?
Dostępność publikacji natychmiastowej zależy od tego, czy wybrana strona obsługuje zautomatyzowaną integrację publikacji (wtyczka BlogDrip dla WordPress lub połączenie Agency API). Każde zamówienie — API lub ręczne — składane na kwalifikującej się stronie może skorzystać z automatycznej publikacji. Nie każda strona na marketplace ją wspiera, więc integracja powinna traktować czas publikacji jako zależny od konkretnej strony, a nie jednolity.
Jaka jest różnica między Advertiser API a Agency API?
Advertiser API jest przeznaczone dla klientów, którzy chcą zautomatyzować zamawianie wpisów gościnnych ze swojego oprogramowania. Agency API jest dla zewnętrznych agencji, platform do budowania linków i sieci wydawców, które chcą podłączyć własny inwentarz do BlogDrip i automatyzować obsługę. Oba są samodzielne — użycie jednego nie wymaga drugiego.
Co się stanie, jeśli ponowię nieudane żądanie tworzenia zamówienia?
Jeśli nie otrzymali Państwo potwierdzonej odpowiedzi, przyjmij, że pierwsze żądanie mogło zostać zrealizowane po stronie serwera. Nie ponawiaj automatycznie nie-idempotentnego żądania tworzenia zamówienia. Dodaj serwerowy klucz de-duplikacji lub zapytaj o ewentualnie utworzone zamówienie przed ponowieniem — w zależności od tego, co lepiej pasuje do workflow. Ponowienie udanego, lecz niewidocznego zamówienia tworzy podwójne obciążenie.
Gotowi do automatyzacji budowania linków?
Otwórz dokumentację API, wygeneruj poświadczenia i zacznij budować. Marketplace skaluje się wraz z Państwa automatyzacją — nie odwrotnie.