Fejlesztői útmutató
Építsen saját linképítés-automatizálót a BlogDrip API-val
Kapcsolja közvetlenül szoftverét a BlogDriphez és automatizálja a vendégposzt-megrendeléseket. Építsen egyedi SEO munkafolyamatokat, integrálja meglévő alkalmazásait, és kezelje a linképítési műveleteket hatékonyabban.
Miért automatizáljon?
Miért érdemes saját linképítés-automatizálót építeni
A SEO ügynökségek és a belső marketing csapatok ugyanabba az operatív mintába ütköznek: kézzel keresnek publikálási lehetőségeket, újra rögzítik a vendégposzt-megrendeléseket, több ügyfélkampányt egyidejűleg kezelnek, adatokat mozgatnak belső rendszerek között, nyomon követik a rendelések állapotát, és próbálják mindezt skálázni anélkül, hogy arányosan növelnék a létszámot.
Egy API-integráció leveszi a csapat ismétlődő, mechanikus munkáját, és kódszinten kezeli azt. A meglévő szoftvere — a CRM, kampánykezelő eszköz vagy egy egyedi műszerfal, amiben a csapata nap mint nap dolgozik — közvetlenül kommunikál a piactérrel. Az operátorok a stratégia, a briefek és a minőségellenőrzés felé fordíthatják a figyelmüket a rendelésfelvitel helyett.
Az automatizálás munkafolyamat-hatékonyságot hoz, nem SEO rangsorolást. Nem teszi sikeressé a rossz kampányt, és nem helyettesíti az emberi megítélést a kiadó kiválasztásában. Amit jól csinál, az az adatbeviteli réteg eltávolítása: amikor eldönti, mit vásároljon, bármilyen mennyiségben végre tudja hajtani.
Mit építhet
Mit hozhat létre a BlogDrip API-val
Gyakorlati minták egy programozott piactéri integrációra épített szoftverhez.
Egyedi vendégposzt irányítópult
Egy belső alkalmazás, amely csatlakozik a BlogDriphez és a csapata által vezérelt felületről küldi a támogatott vendégposzt-megrendeléseket.
SEO ügynökségi menedzsment rendszer
A vendégposzt-megrendelés be van kötve a meglévő ügynökségi munkafolyamatba, így a kampánymenedzserek nem hagyják el az általuk már használt rendszert.
Automatizált megrendelésküldés
Az API-kérések tételesen létrehozzák a támogatott vendégposzt-megrendeléseket, a megrendelésenkénti kézi adatbeviteli lépés nélkül.
Ügyfélkampány-kezelés
Kapcsolja össze a belső ügyfél- és kampányadatokat a BlogDrip rendelési munkafolyamataival — egyetlen, megbízható forrás arról, ki mit vásárol.
Munkafolyamat automatizálás
Indítson támogatott API-műveleteket belső üzleti folyamatokból — jóváhagyások, indítások, ütemezett kampányhullámok.
Jelentéskészítés és monitorozás
Húzza be a rendeléshez kapcsolódó információkat a támogatott egyedi jelentési eszközeibe. A jelentéseket az API által valóban kitettre szűkítse, ne feltételezzen teljes valós idejű láthatóságot.
Architektúra
Példa az automatizációs architektúrára
Egy egészséges integráció a felelősségi köröket négy réteg között választja szét.
Legfelül az Ön külső automatizációs alkalmazása helyezkedik el — egy egyedi műszerfal, SEO ügynökségi szoftver, belső CRM vagy kampánykezelő rendszer. Itt dolgozik a csapata nap mint nap.
Alatta az alkalmazás backendje található. Feladatai azok, amelyeket minden integrációnak helyesen kell kezelnie: biztonságosan tárolni a `x-client-id` és `x-client-secret` értékeket, érvényesíteni a bemenetet, mielőtt az eljutna a BlogDriphez, előkészíteni és elküldeni az API-kéréseket, kezelni a `{ data, pagination }` válaszokat, naplózni az operatív eseményeket, és biztonságosan újrapróbálkozni, hogy egy átmeneti hálózati hiba ne váljon duplikált fizetett megrendeléssé.
Innen a kérések elérik a BlogDrip Advertiser API-t — a publikus, verzionált felületet az `/api/public/*` alatt — amely kiteszi a támogatott vendégposzt-megrendelési funkciókat.
Az API a rendelések továbbítását a BlogDrip piactérre irányítja — több mint 275,000 webhely teljes készlete — majd onnan a rendelésfeldolgozási és publikálási munkafolyamatba. A kiválasztott webhelytől függően a publikáció lehet manuális a kiadó oldalán vagy automatizált a WordPress bővítményen vagy az Agency API-n keresztül. Nem minden piactéri webhely támogatja az Instant Publishinget, ezért az integrációnak a publikáció időzítését munkafolyamat-függőként kell kezelnia, nem azonnaliként.
Építse fel automatizációs eszközét lépésről lépésre
Nyolc lépés a tervezéstől a monitorozásig. Vegye őket referenciaanyagnak, nem merev sorrendnek — sok lépés párhuzamosan is fut.
Határozza meg az automatizációs munkafolyamatot
Azonosítsa, mely feladatokat érdemes automatizálni, milyen információra van szüksége az alkalmazásának, mikor kell leadni egy megrendelést, hogyan kerülhetők el a duplikált rendelések, hogyan kezelődnek a hibák, és hogyan tárolódnak a kampányadatok. Egy konkrét példa a felmérésre: egy ügynökség 20 ügyfelet kezel, ügyfelenként 3–5 aktív kampánnyal; azt szeretnék, hogy az új kampányok automatikusan megrendeléseket generáljanak egy előre jóváhagyott webhelylistára — de csak miután egy ember jóváhagyta a kampánybriefet.
Szerezze be a BlogDrip API-hozzáférést
Nyissa meg fiókját az app.blogdrip.com/settings címen, majd lépjen a Saját beállítások → API-hozzáférés menüponthoz, hogy megtalálja a hitelesítő adatait. Két értéket fog látni: egy `x-client-id`-t és egy `x-client-secret`-et. A secret egyszer jelenik meg kiadáskor vagy forgatáskor, ezért azonnal másolja át a titoktárolójába. A hozzáféréshez havi minimum €500 összkiadás szükséges fiókonként — a manuális rendelések és az API-rendelések egyaránt beleszámítanak. Ha a hónap során nem teljesül a minimum, az API-hozzáférés automatikusan deaktiválódik. A €500 egy költési küszöb, nem külön API-előfizetési díj.
Olvassa el az API dokumentációt
A hivatalos dokumentáció az app.blogdrip.com/api/public/docs/index.html címen pontosan leírja az `/api/public/*` névtér alatti végpontokat, a hitelesítést (a fent említett két fejlécpár), a kérési módokat, a kötelező paramétereket, a válaszformátumokat (a listázó végpontok `{ data, pagination }` csomagolást használnak 0-alapú `?page=0` számozással), a validációs hibákat (`{ message }`), és az elérhető rendelési műveleteket. Tekintse a dokumentációt a tekintélyes forrásnak: ha egy paraméter nincs dokumentálva, ne feltételezze a létezését.
Építse fel az API-kapcsolatot
Hozzon létre egy alkalmazás backendet, amely biztonságosan tárolja mind a `x-client-id`-t, mind a `x-client-secret`-et (környezeti változók, titoktároló — soha ne a frontend kódban), küld autentikált kéréseket mindkét fejléc beállításával, elemzi a válaszokat, kezeli a hibákat, és struktúrált naplókat ír minden kimenő hívásról. Tartsa az API-klienst egy kis, jól tesztelt modulban, hogy az alkalmazás többi része soha ne beszéljen közvetlenül a BlogDrippel.
Valósítsa meg az automatizált vendégposzt-megrendelést
Csatlakoztassa belső munkafolyamatát a támogatott BlogDrip rendelési műveletekhez. Egy tipikus folyamat: az Ön rendszerében létrejön egy új kampány → kiválasztanak egy webhelyet (oldja fel a `marketSiteId`-t a piactéri végpontokból) → az alkalmazás előkészíti a szükséges rendelési adatokat (cím, URL, leírás, `categoryId`, `marketSiteId`, `campaignId`, opcionális `scheduleDate`, `linkNoFollow`) → a backend érvényesíti a rendelést az üzleti szabályok szerint → az alkalmazás elküldi a megrendelést az Advertiser API-n keresztül → a választ eltárolják a nyomon követhetőség érdekében. Érvényesítsen minden mezőt az OpenAPI specifikáció szerint, mielőtt leadná a megrendelést.
Hibák és duplikált rendelések kezelése
Érvényesítse a kéréseket benyújtás előtt, akadályozza meg a véletlen duplikált megrendeléseket (egy idempotencia-kulcs vagy szerveroldali deduplikációs ellenőrzés biztonságos minta), naplózza minden API-hibát elegendő kontextussal a későbbi hibakereséshez, kezelje a rövid ideig tartó kapcsolódási problémákat elegánsan, és tartsa tiszteletben a dokumentált rate-limit korlátokat. Egy alapelv: soha ne próbálja automatikusan újra elküldeni a nem idempotens megrendelés létrehozási kérést emberi vagy rendszerszintű megerősítés nélkül — egy újrapróbálkozás egy sikeres, de nem látott válaszú rendelésnél kettős terhelést eredményez.
Tesztelje az integrációt
Ha dokumentált sandbox környezet áll rendelkezésre, futtassa ott az integrációt. Ha nincs sandbox, teszteljen a production ellen óvatosan — soha ne futtasson automatikus tesztsorozatokat, amelyek valós, fizetett megrendeléseket hoznak létre engedély nélkül. Használjon dedikált tesztkampányt emberi ellenőrzéssel az első automatizált rendelés előtt, és korlátozza az automatizált tesztfuttatásokat egy rövid, előre jóváhagyott webhelylistára, amelyet integrációs tesztelésre jóváhagyott.
Telepítse és figyelje
Helyezze át a hitelesítő adatokat a gyártási titoktárolóba, adjon hozzá monitorozást az integrációs hibákra és a szokatlan megrendelésküldési mintákra, kövesse a rendelésküldési eredményeket end-to-end, őrizze meg az operatív naplókat elég hosszú ideig ahhoz, hogy egy kéthetes incidens hibakeresése megtörténhessen, figyelje a fiókköltéseket, hogy ne veszítse el az API-hozzáférést az €500 havi minimum alá csökkenés miatt, és figyelje a BlogDrip változásnaplóját az olyan API-frissítések miatt, amelyek integrációs karbantartást igényelhetnek.
Integrációs minták
Hogyan néz ki egy jól működő integráció
Az végrehajtható példák tekintetében az OpenAPI specifikáció az app.blogdrip.com/api/public/openapi.json címen és az emberi olvasásra szánt dokumentáció az /api/public/docs alatt a tekintélyes források. A specifikáció alapján generálja vagy ellenőrizze a kódot — ne egy landing-oldali kivonat alapján, ami elavulhat.
Gyakorlatban egy tiszta integráció jellemzően hasonló alakot követ. Egy vékony API-klienst modul a preferált nyelvben — egy wrapper függvény műveletenként — kezeli a mechanikát: minden kérésnél beállítja a `x-client-id` és `x-client-secret` fejlécet, szerializálja a kérés törzsét, deszerializálja a listázó végpontok `{ data, pagination }` borítóját (0-alapú lapozás), és a hibaválaszokat (`{ message }`) olyan kivételekké alakítja, amelyeket az üzleti logika tisztán el tud kapni. Minden wrapperhez tartozzon legalább egy teszt, amely az dokumentált alakra ellenőriz — így egy séma-változás teszthalálozásként jelenik meg, mielőtt a productionbe kerülne. Csak miután ez a modul stabil, kösse be a rendszer többi részébe — kampány trigger-ek, rendelési sorok, újrapróbáló munkák, riportok.
Ez a sorrend teszi auditálhatóvá az integrációt: az API kliens egy kis, jól tesztelt felület; minden más ezen keresztül beszél a BlogDrippel.
Legjobb gyakorlatok
Mi tart egy API-integrációt hosszú távon életben
Minták, amelyek az automatizált rendszereket egészségesen tartják jóval az indulás után is.
Idempotencia a tervezésben
Kezelje a rendelés létrehozását drágának és visszafordíthatatlannak. Deduplikáljon az Ön oldalán, mielőtt a kérés elküldésre kerül — soha utólag.
Hitelesítő adatok kezelése
Az API-hitelesítők titoktárolóban legyenek, környezetenként szegmentálva. Forgassa őket kilépéskor, ne csak incidens esetén.
Strukturált naplózás
Minden kérés + válasz páros kapjon korrelációs azonosítót. A jövőbeni Ön, aki egy régi rendelést hibakeres, hálás lesz a jelenlegi Önnek.
Rate-limit-tudatos kliensek
Tisztelje a dokumentált rate-limit korlátokat. Egy olyan kliens, amely tisztán visszalép, jobban skálázódik, mint amely agresszívan újrapróbálkozik.
Ember a folyamatban
Őrizze meg az első production hívást emberi jóváhagyás mögött. Bővítse az automatizációt csak miután az integráció stabilnak bizonyult.
Költésfigyelés
Értesítsen, ha a havi fiókköltés az €500 felé tart vagy az alá csökken. Közben egy kampányon belüli API-hozzáférés elvesztése fájdalmas.
Gyakran ismételt kérdések
Kinek szól a BlogDrip API?
Azoknak a advertiser fiókoknak, amelyek saját szoftverüket — egy egyedi műszerfalat, SEO ügynökségi platformot vagy belső CRM-et — szeretnék csatlakoztatni a BlogDrip vendégposzt-megrendelési munkafolyamatához. Tipikus felhasználók: volumenben kampányokat kezelő ügynökségek, meglévő stackkel integráló in-house SEO csapatok és fejlesztők, akik ügyfél- vagy termékspecifikus operatív eszközöket építenek.
Fejlesztőnek kell lennem az API használatához?
Magát az integrációt építeni igen, szükség van fejlesztői munkára. Az API programozott interfész — használatához kódot kell írni vagy fejlesztővel együtt dolgozni. Ha az operatív előnyökre vágyik integráció nélkül, a piactér UI ugyanazt a rendelési funkcionalitást kézi úton is lefedi.
Milyen hozzáférési követelmények vannak?
Egy aktív BlogDrip fiók, amely legalább €500-t költ havonta összességében — a manuális és az API rendelések egyaránt beleszámítanak a küszöbbe. Ha egy adott hónapban a fiók kevesebbet költ, az API-hozzáférés automatikusan deaktiválódik. A €500 egy volumenküszöb, nem külön API-előfizetési díj.
Hol találom az API dokumentációt?
A hivatalos API dokumentáció az app.blogdrip.com/api/public/docs/index.html címen érhető el, a géppel olvasható OpenAPI specifikáció pedig az app.blogdrip.com/api/public/openapi.json címen. Mindkettő leírja a hitelesítési sémát, az `/api/public/*` névtér alatti teljes végpontlistát, a kérés- és válaszformákat, a lapozási formátumot és a hibaválaszokat. Tekintse ezeket az integráció tekintélyes forrásának.
Hol találom az API hitelesítő adataimat?
A Saját beállítások → API-hozzáférés menüpontban az app.blogdrip.com/settings címen. Két értéket kap: `x-client-id` és `x-client-secret`; mindkettőt minden autentikált kérés HTTP fejlécében kell elküldeni. A secret egyszer jelenik meg kiadáskor vagy forgatáskor — másolja át azonnal a titoktárolójába, mert később nem kérhető le. A hitelesítők fiókonkéntiak; kezelje őket más titkokhoz hasonlóan, és ne tegye verziókezelésbe.
Hogyan működik a lapozás a listázó végpontokon?
A listázó végpontok válaszát `{ data, pagination }` borítóba csomagolják, és 0-alapú lapozást használnak — adja meg `?page=0`-t az első oldalhoz, `?page=1`-et a másodikhoz, és így tovább. A válasz pagination blokkja jelzi, hogy vannak-e további oldalak. Ha a régi `/api/<path>` interfészről migrál, a válasz formája változatlan — csak a base path költözik az `/api/public/*` alá.
Támogatja az API a webhookokat?
Ellenőrizze az OpenAPI specifikációt az app.blogdrip.com/api/public/openapi.json címen a jelenleg támogatott callback vagy eseményértesítési mechanizmusok listájáért. Ha egy funkció nincs felsorolva, építse az integrációt úgy, hogy ne feltételezze annak létezését — az API időnkénti lekérdezése saját ütemezés szerint biztonságos tartalékmegoldás.
Van sandbox környezet?
A tekintélyes válasz a jelenlegi API dokumentációban található. Ha szerepel sandbox, használja azt integrációs tesztelésre. Ha nincs megadva, ne hozza létre automatikusan valós, fizetett rendelések tesztelés céljából engedély nélkül — használjon dedikált tesztkampányt és emberi felülvizsgálatot.
Használhatnak-e az API rendelések Instant Publishinget?
Az Instant Publishing elérhetősége attól függ, hogy a kiválasztott webhely támogatja-e az automatizált publikálási integrációt (például a BlogDrip WordPress bővítményt vagy egy Agency API kapcsolatot). Bármely rendelés — API-s vagy manuális —, amelyet egy jogosult webhelyre helyeznek, élvezheti az automatizált publikáció előnyeit. Nem minden piactéri webhely támogatja ezt, ezért integrációjának a publikáció időzítését webhelyenként kell kezelnie, nem egységesen.
Mi a különbség az Advertiser API és az Agency API között?
Az Advertiser API azoknak a vásárlóknak szól, akik saját szoftverükből szeretnék automatizálni a vendégposzt-megrendelést. Az Agency API külső ügynökségeknek, linképítő platformoknak és kiadói hálózatoknak szól, akik saját inventory-jukat szeretnék csatlakoztatni a BlogDriphez és automatizálni a támogatott fulfillmentet. Mindkettő önálló — az egyik használata nem követeli meg a másik használatát.
Mi történik, ha újrapróbálok egy sikertelen megrendelés létrehozási kérést?
Ha nem látta a megerősített választ, feltételezze, hogy az első kérés esetleg sikeres volt a szerver oldalon. Ne próbálja automatikusan újra a nem idempotens megrendelés létrehozási kérést. Adjon szerveroldali deduplikációs kulcsot, vagy kérdezze le a esetleg létrejött rendelést újrapróbálkozás előtt — ahogy az Ön munkafolyamata tisztán támogatja. Egy újrapróbálkozás egy sikeresnek bizonyult, de nem látott rendelésnél kettős terhelést okoz.
Készen áll a linképítés automatizálására?
Nyissa meg az API dokumentációt, generálja hitelesítő adatait, és kezdjen építeni. A piactér az Ön automatizációjával skálázódik — nem fordítva.