Utviklerguide
Bygg ditt eget verktøy for automatisert lenkebygging med BlogDrip API
Koble programvaren din direkte til BlogDrip og automatiser bestillinger av gjesteposter. Bygg tilpassede SEO‑arbeidsflyter, integrer eksisterende applikasjoner og håndter lenkebyggingsarbeidet mer effektivt.
Hvorfor automatisere
Hvorfor bygge ditt eget verktøy for automatisert lenkebygging
SEO-byråer og interne markedsføringsteam møter ofte det samme operative mønsteret: de søker manuelt etter publiseringsmuligheter, legger inn bestillinger av gjesteposter på nytt, jonglerer flere kundekampanjer, overfører informasjon mellom interne systemer, følger med på ordrestatus og forsøker å skalere alt dette uten tilsvarende økning i bemanning.
En API-integrasjon tar det repeterende, mekaniske arbeidet av teamets bord og kjører det gjennom kode. Din eksisterende programvare — CRM-en, kampanjeverktøyet eller det tilpassede dashbordet teamet allerede bruker — snakker direkte med markedsplassen. Operatører kan fokusere på strategi, brief og kvalitetskontroll i stedet for ordreregistrering.
Automatisering gir arbeidsflyteffektivitet, ikke SEO-rangeringer. Det vil ikke få en dårlig kampanje til å lykkes, og det vil ikke erstatte menneskelig dømmekraft ved valg av utgiver. Det det gjør godt, er å fjerne laget med datainntasting, slik at når du bestemmer hva som skal kjøpes, kan du gjennomføre det i hvilken som helst skala.
Hva du kan bygge
Hva du kan bygge med BlogDrip API
Praktiske mønstre for programvare bygget på en programmatisk markedsplassintegrasjon.
Tilpasset gjestepost-dashboard
En intern applikasjon som kobler til BlogDrip og sender støttede bestillinger av gjesteposter fra et brukergrensesnitt teamet ditt kontrollerer.
Administrasjonssystem for SEO-byrå
Gjestepostbestillinger koblet inn i en eksisterende byråarbeidsflyt, slik at kampanjeansvarlige aldri trenger å forlate systemet de allerede bruker.
Automatisk ordreinnsending
API-forespørsler oppretter støttede bestillinger av gjesteposter i batch, uten manuell registrering per ordre.
Kunde- og kampanjestyring
Koble interne kunde- og kampanjeposter til BlogDrip-bestillingsflyter — én sannhetskilde for hvem som kjøper hva.
Workflow-automatisering
Trigge støttede API-operasjoner fra interne forretningsprosesser — godkjenninger, kickoffs, planlagte kampanjebølger.
Rapportering og overvåking
Hent ordrerelatert informasjon inn i egne rapportverktøy der det støttes. Avgrens rapporteringen til det API-et faktisk eksponerer i stedet for å anta full sanntidsinnsyn.
Arkitektur
Eksempel på automasjonsarkitektur
En god integrasjon skiller ansvar over fire lag.
Øverst ligger din eksterne automatiseringsapplikasjon — et eget dashbord, SEO-byråprogramvare, intern CRM eller kampanjestyringssystem. Her jobber teamet ditt daglig.
Under det ligger applikasjonsbackend-en din. Ansvarsområdene her er de enhver integrasjon må få riktig: lagre `x-client-id` og `x-client-secret` sikkert, validere input før det når BlogDrip, forberede og sende API-forespørsler, håndtere `{ data, pagination }`-svar, logge operative hendelser og administrere retryer på en sikker måte slik at en midlertidig nettverksfeil ikke blir til en duplikat betalt ordre.
Deretter treffer forespørslene BlogDrip Advertiser API — den offentlige, versjonerte flaten under `/api/public/*` — som eksponerer den støttede bestillingsfunksjonaliteten for gjesteposter.
API-et ruter ordre inn i BlogDrip-markedsplassen — mer enn 275,000 nettsteder i samlet inventar — og derfra inn i aktuell ordrebehandling og publiseringsflyt. Avhengig av valgt nettsted kan publisering være manuell hos utgiveren eller automatisert gjennom WordPress-pluginen eller Agency API. Ikke alle nettsteder i markedsplassen støtter Instant Publishing, så integrasjonen din bør behandle publiseringstidspunkt som avhengig av arbeidsflyt, ikke umiddelbar.
Bygg automatiseringsverktøyet ditt, steg for steg
Åtte steg fra avgrensing til overvåking. Bruk dem som referanse, ikke en streng sekvens — mange kjører parallelt.
Definer automasjonsflyten din
Identifiser hvilke oppgaver som bør automatiseres, hvilke data applikasjonen din trenger, når en ordre skal sendes inn, hvordan du forhindrer duplikate ordrer, hvordan feil håndteres, og hvordan kampanjedata lagres. Et konkret avgrensningseksempel: et byrå som administrerer 20 kunder, hver med 3–5 aktive kampanjer, ønsker at nye kampanjer automatisk genererer ordre for en kortliste med forhåndsgodkjente nettsteder — men bare etter at en person har godkjent kampanjebriefen.
Skaff BlogDrip API-tilgang
Åpne kontoen din på app.blogdrip.com/settings og gå til My Settings → API access for å finne legitimasjonen din. Du vil se to verdier: en `x-client-id` og en `x-client-secret`. Secret vises én gang når den utstedes eller roteres, så kopier den til din secret manager umiddelbart. Tilgang krever minst €500 per måned i total kontoaktivitet — manuelle ordre teller, API-ordre teller, begge spor kombinert. API-tilgang deaktiveres automatisk hvis minimumet ikke er oppfylt i en gitt måned. €500 er et forbruksgrense, ikke et separat API-abonnement.
Les API-dokumentasjonen
De offisielle dokumentene på app.blogdrip.com/api/public/docs/index.html beskriver de nøyaktige endepunktene under `/api/public/*`-navneområdet, autentisering (de to header-parene nevnt ovenfor), forespørselstyper, obligatoriske parametere, responsformater (listeendepunkter pakker svar i `{ data, pagination }` med 0-basert `?page=0`), valideringsfeil (`{ message }`) og tilgjengelige bestillingsoperasjoner. Behandle dokumentasjonen som autoritativ: hvis en parameter ikke er dokumentert, anta ikke at den finnes.
Bygg API-tilkoblingen
Lag en applikasjonsbackend som lagrer både `x-client-id` og `x-client-secret` sikkert (miljøvariabler, secret manager — aldri i frontend-kode), sender autentiserte forespørsler med begge headere satt, parser svar, håndterer feil og skriver strukturerte logger for hver utgående kall. Hold API-klienten som en liten, godt testet modul slik at resten av applikasjonen aldri snakker med BlogDrip direkte.
Implementer automatisk bestilling av gjesteposter
Koble din interne arbeidsflyt til de støttede BlogDrip-bestillingsoperasjonene. En typisk flyt: en ny kampanje opprettes i systemet ditt → et nettsted velges (finn `marketSiteId` fra markedsplass-endepunktene) → applikasjonen din forbereder nødvendig ordreinfo (tittel, URL, beskrivelse, `categoryId`, `marketSiteId`, `campaignId`, valgfritt `scheduleDate`, `linkNoFollow`) → backend validerer ordren mot forretningsreglene dine → applikasjonen sender ordren gjennom Advertiser API → responsen lagres i systemet ditt for sporbarhet. Valider hvert felt mot OpenAPI-spesifikasjonen før produksjon.
Håndter feil og duplikate ordrer
Valider forespørsler før innsending, forhindre utilsiktede duplikate ordrer (en idempotency-nøkkel eller en serverside de-duplikasjonskontroll på din side er et trygt mønster), logg hver API-feil med nok kontekst til å feilsøke senere, håndter midlertidige tilkoblingsproblemer grasiøst, og respekter eventuelle dokumenterte rate limits. En regel å internalisere: prøv aldri automatisk igjen en ikke-idempotent ordreopprettingsforespørsel uten eksplisitt menneskelig eller systembekreftelse — et retry på en vellykket ordre du ikke fikk responsen for skaper dobbeltbelastning.
Test integrasjonen din
Kjør integrasjonen mot et sandbox-miljø hvis et slikt er dokumentert. Hvis ingen sandbox er tilgjengelig, test mot produksjon forsiktig — kjør aldri automatiserte testsett som oppretter ekte betalte ordre uten eksplisitt autorisasjon. Bruk en dedikert testkampanje med menneskelig gjennomgang før den første automatiske ordren sendes, og begrens automatiserte testrunner til en kort liste over nettsteder du forhåndsgodkjenner for integrasjonstesting.
Deploy og overvåk
Flytt legitimasjonen inn i ditt produksjonssecret-lager, legg til overvåking for integrasjonsfeil og uvanlige bestillingsmønstre, spor ordreinnsendingsresultater ende-til-ende, behold operative logger lenge nok til å feilsøke en to uker gammel hendelse, overvåk kontoforbruket ditt slik at du ikke mister API-tilgang ved å falle under €500 månedlig minimum, og følg BlogDrip changelog for API-oppdateringer som kan kreve vedlikehold av integrasjonen.
Integrasjonsmønstre
Slik ser en robust integrasjon ut
Den autoritative kilden for kjørbare eksempler er OpenAPI-spesifikasjonen på app.blogdrip.com/api/public/openapi.json og de menneskelesbare dokumentene på /api/public/docs. Spesifikasjonen er det koden din bør genereres fra eller sjekkes mot — ikke en landingssidebit som kan bli utdatert.
I praksis følger en ryddig integrasjon ofte samme form. En tynn API-klientmodul i foretrukket språk — én wrapper-funksjon per operasjon du trenger — håndterer mekanikken: den setter `x-client-id` og `x-client-secret` headerne på hver forespørsel, serialiserer request body, deserialiserer `{ data, pagination }`-konvolutten på listeendepunkter (0-basert paging), og konverterer feilsvar (`{ message }`) til unntak som forretningslogikken kan fange rent. Hver wrapper har minst én test som asserterer på den dokumenterte formen, slik at et skjemaendring gir en feilede test før det når produksjon. Først når den modulen er stabil, kobler du den inn i resten av applikasjonen — kampanjetriggere, ordre-køer, retry-workers, rapportering.
Den rekkefølgen gjør integrasjonen reviderbar: API-klienten din er et lite, godt testet overflateareal; alt annet snakker med BlogDrip gjennom den.
Beste praksis
Hva som gjør en API-integrasjon varig
Mønstre som holder automatiserte systemer sunne lenge etter lansering.
Idempotens by design
Behandle ordreoppretting som kostbar og irreversibel. De-dupliser på din side før forespørselen sendes — aldri etterpå.
Ryddig håndtering av legitimasjon
API-legitimasjon hører hjemme i en secret manager, avgrenset per miljø. Roter dem ved fratredelse, ikke ved brudd.
Strukturert logging
Hvert request + response-par får en korrelasjons-ID. Fremtidige deg som feilsøker en gammel ordre vil takke nåværende deg.
Rate-limit-bevisste klienter
Respekter dokumenterte rate limits. En klient som backer av ordentlig, skalerer bedre enn en som gjør aggressive retries.
Menneske i loop
Sikre første produksjonskall bak en menneskelig godkjennelse. Utvid automatiseringen først etter at integrasjonen har vist seg stabil.
Overvåk forbruk
Varsle når månedlig kontoaktivitet nærmer seg eller faller under €500. Å miste API-tilgang midt i en kampanje er smertefullt.
Vanlige spørsmål
Hvem er BlogDrip API ment for?
Annonsørkontoer som vil koble sin egen programvare — et tilpasset dashbord, en SEO-byråplattform eller en intern CRM — til BlogDrip sin bestillingsflyt for gjesteposter. Typiske brukere er byråer som håndterer kampanjer i volum, interne SEO‑team som integrerer med eksisterende stack, og utviklere som bygger operative verktøy for en bestemt kunde eller produkt.
Må du være utvikler for å bruke API-et?
For å bygge selve integrasjonen, ja. API-et er et programmatisk grensesnitt — bruk krever koding eller samarbeid med en utvikler. Hvis du vil ha de operative fordelene uten integrasjonsarbeidet, dekker markedsplassens brukergrensesnitt samme bestillingsfunksjonalitet manuelt.
Hva kreves for å få tilgang?
En aktiv BlogDrip-konto som bruker minst €500 per måned totalt — både manuelle ordre og API-ordre teller mot terskelen. API-tilgang deaktiveres automatisk hvis kontoen bruker mindre i en gitt måned. €500 er en volumbergrense, ikke et separat API-abonnement.
Hvor finner jeg API-dokumentasjonen?
Den offisielle API-dokumentasjonen publiseres på app.blogdrip.com/api/public/docs/index.html, med den maskinlesbare OpenAPI-spesifikasjonen på app.blogdrip.com/api/public/openapi.json. Begge beskriver autentiseringsskjemaet, hele endepunktskatalogen under `/api/public/*`-navneområdet, request- og response-former, paginering og feilsvar. Behandle dem som sannhetskilden for integrasjonen din.
Hvor finner jeg API-legitimasjonen min?
I My Settings → API access på app.blogdrip.com/settings. Du får en `x-client-id` og en `x-client-secret`; begge må med i hver autentisert forespørsel som HTTP-headere. Secret vises én gang når den utstedes eller roteres — kopier den til din secret manager umiddelbart, da den ikke kan hentes senere. Legitimasjon er per konto; behandle dem som andre hemmeligheter og hold dem ute av versjonskontroll.
Hvordan fungerer paginering på listeendepunkter?
Listeendepunkter pakker svarene i en `{ data, pagination }`-konvolutt og bruker 0-basert paging — send `?page=0` for første side, `?page=1` for andre, og så videre. Paginering-blokken i responsen forteller om flere sider finnes. Hvis du migrerer fra det gamle `/api/<path>`-grensesnittet, er responsskjemaet uendret — bare basepath flytter til `/api/public/*`.
Støtter API-et webhooks?
Sjekk OpenAPI-spesifikasjonen på app.blogdrip.com/api/public/openapi.json for den aktuelle listen over støttede callback- eller event-notifikasjonsmekanismer. Hvis en funksjon ikke er oppført, bygg integrasjonen uten å anta at den finnes — polling av API-et etter eget tidsskjema er et trygt fallback.
Finnes det et sandbox-miljø?
Det autoritative svaret står i den aktuelle API-dokumentasjonen. Hvis et sandbox er oppført, bruk det for integrasjonstesting. Hvis det ikke er listet, opprett ikke ekte betalte ordre under automatisert testing uten eksplisitt autorisasjon — bruk en dedikert testkampanje og menneskelig gjennomgang i stedet.
Kan API-ordrer bruke Instant Publishing?
Tilgjengeligheten av Instant Publishing avhenger av om det valgte nettstedet har en støttet automatisert publiseringsintegrasjon (enten BlogDrip WordPress-plugin eller en Agency API-tilkobling). Enhver ordre — API eller manuell — plassert på et kvalifisert nettsted kan dra nytte av automatisert publisering. Ikke alle nettsteder i markedsplassen støtter det, så integrasjonen din bør behandle publiseringstidspunkt per nettsted, ikke som enhetlig.
Hva er forskjellen mellom Advertiser API og Agency API?
Advertiser API er for kunder som vil automatisere bestillinger av gjesteposter fra sin egen programvare. Agency API er for eksterne byråer, lenkebyggingsplattformer og utgivernettverk som vil koble sitt eget inventar til BlogDrip og automatisere støttet oppfyllelse. Begge er frittstående — bruk av den ene krever ikke den andre.
Hva skjer hvis jeg prøver på nytt en mislykket ordreopprettingsforespørsel?
Hvis du ikke så en bekreftet respons, anta at første forespørsel kan ha lykkes på serversiden. Ikke gjør automatiske retries av ikke-idempotente ordreopprettinger. Legg til en serverside de-duplikasjonsnøkkel, eller søk etter den muligens opprettede ordren før du prøver igjen — hva enn arbeidsflyten din støtter rent. Et retry på en vellykket-men-ikke-sett ordre skaper dobbeltbelastning.
Klar til å automatisere lenkebyggingen din?
Åpne API-dokumentasjonen, generer legitimasjonen dine og begynn å bygge. Markedsplassen skalerer med automasjonen din — ikke motsatt.