Udviklerguide
Byg dit eget værktøj til automatiseret linkopbygning med BlogDrip API
Forbind din software direkte med BlogDrip og automatiser bestilling af gæsteindlæg. Byg tilpassede SEO-arbejdsgange, integrer dine eksisterende applikationer, og håndtér linkopbygningsarbejdet mere effektivt.
Hvorfor automatisere
Hvorfor bygge dit eget automationsværktøj til linkopbygning
SEO-bureauer og interne marketingteams støder på det samme operationelle mønster: manuelt at søge efter publiceringsmuligheder, genindtaste bestillinger af gæsteindlæg, jonglere flere kundekampagner, overføre information mellem interne systemer, overvåge ordreforløb og forsøge at skalere alt dette uden tilsvarende øget bemanding.
En API-integration tager det gentagne, mekaniske arbejde af dit teams bord og lader det køre via kode. Jeres eksisterende software — CRM'en, kampagnestyringsværktøjet eller det custom-dashboard, dit team allerede bruger — taler direkte med markedspladsen. Operatørerne kan fokusere på strategi, briefs og kvalitetssikring i stedet for ordreindtastning.
Automatisering leverer effektivitet i arbejdsgange, ikke SEO-placeringer. Den får ikke en dårlig kampagne til at lykkes, og den erstatter ikke menneskelig dømmekraft ved valg af udgiver. Det den gør godt, er at fjerne dataindtastningslaget, så når du har besluttet, hvad der skal købes, kan du eksekvere i enhver volumen.
Hvad du kan bygge
Hvad du kan bygge med BlogDrip API
Praktiske mønstre for software, der bygger på en programmatisk markedspladsintegration.
Eget dashboard til gæsteindlæg
En intern applikation, der forbinder til BlogDrip og indsender understøttede bestillinger af gæsteindlæg fra en brugergrænseflade, dit team kontrollerer.
Managementsystem til SEO-bureau
Bestilling af gæsteindlæg integreret i en eksisterende bureauarbejdsgang, så kampagneansvarlige aldrig forlader det system, de allerede bruger.
Automatiseret ordreindsendelse
API-forespørgsler opretter understøttede bestillinger af gæsteindlæg i batch, uden det manuelle dataindtastnings‑trin per ordre.
Kundekampagnestyring
Forbind interne kunde- og kampagneregistre til BlogDrip-bestillingsarbejdsgange — én sandhedskilde for, hvem der køber hvad.
Automatisering af arbejdsgange
Udløs understøttede API‑operationer fra interne forretningsprocesser — godkendelser, opstarter og planlagte kampagnebølger.
Rapportering og overvågning
Hent ordre-relateret information ind i tilpassede rapporteringsværktøjer, hvor det er understøttet. Afgræns rapporteringen til det, API'en rent faktisk eksponerer, i stedet for at antage fuld realtidsindsigt.
Arkitektur
Eksempel på automationsarkitektur
En sund integration adskiller ansvar på tværs af fire lag.
Øverst ligger din eksterne automationsapplikation — et custom-dashboard, SEO-bureausoftware, internt CRM eller kampagnestyringssystem. Her arbejder dit team dagligt.
Under det ligger din applikationsbackend. Dens ansvarsområder er de ting, enhver integration skal have styr på: opbevar `x-client-id` og `x-client-secret` sikkert, validér input før det når BlogDrip, forbered og send API-forespørgsler, håndter `{ data, pagination }`-svar, log operationelle hændelser, og administrér retries sikkert, så et kortvarigt netværksproblem ikke bliver til en dobbeltbetalt ordre.
Derfra rammer forespørgslerne BlogDrip Annonsør-API'en — den offentlige, versionerede surface under `/api/public/*` — som eksponerer den understøttede funktionalitet til bestilling af gæsteindlæg.
API'en ruter ordrer ind i BlogDrip-markedspladsen — mere end 275,000 websites i alt — og derfra videre ind i den relevante ordrebehandling og publiceringsarbejdsgang. Afhængigt af det valgte website kan publicering være manuel på udgiverens side eller automatiseret via WordPress-plugin'et eller Bureau-API'en. Ikke alle websites på markedspladsen understøtter Instant Publishing, så din integration bør behandle publiceringstidspunktet som arbejdsgangsafhængigt, ikke øjeblikkeligt.
Byg dit automationsværktøj, trin for trin
Otte trin fra scope til overvågning. Brug dem som reference, ikke en stiv rækkefølge — mange kører parallelt.
Definér din automationsarbejdsgang
Identificer hvilke opgaver der skal automatiseres, hvilke oplysninger din applikation har brug for, hvornår en ordre skal sendes, hvordan du forhindrer dublerede ordrer, hvordan fejl håndteres, og hvordan kampagnedata gemmes. Et konkret scoping-eksempel: et bureau, der styrer 20 kunder, hver med 3–5 aktive kampagner, ønsker at nye kampagner automatisk genererer ordrer til en shortlist af forudgodkendte websites — men kun efter en menneskelig godkendelse af kampagnebriefen.
Få adgang til BlogDrip API
Åbn din konto på app.blogdrip.com/settings og gå til Mine indstillinger → API-adgang for at finde dine legitimationsoplysninger. Du vil se to værdier: et `x-client-id` og et `x-client-secret`. Secret'en vises en enkelt gang ved udstedelse eller rotation, så kopier den straks ind i din secret manager. Adgang kræver mindst €500 pr. måned i samlet konto‑forbrug — både manuelle ordrer og API-ordrer tæller. API-adgang deaktiveres automatisk, hvis minimumsgrænsen ikke er opfyldt i en given måned. De €500 er en forbrugsterskel, ikke et separat API-abonnement.
Læs API-dokumentationen
De officielle docs på app.blogdrip.com/api/public/docs/index.html beskriver de præcise endpoints under `/api/public/*`-namespace'et, autentificering (de to header-par nævnt ovenfor), request-metoder, påkrævede parametre, response-formater (listeendpoints pakker svarene i `{ data, pagination }` med 0-baseret `?page=0`), valideringsfejl (`{ message }`) og tilgængelige bestillingsoperationer. Betragt dokumentationen som autoritativ: hvis en parameter ikke er dokumenteret, antag ikke, at den findes.
Byg API-forbindelsen
Opret en applikationsbackend, der opbevarer både `x-client-id` og `x-client-secret` sikkert (environment variables, secret manager — aldrig i frontendkode), sender autentificerede forespørgsler med begge headers sat, parser svar, håndterer fejl og skriver strukturerede logs for hvert udgående kald. Hold API-klienten som et lille, veltestet modul, så resten af din applikation aldrig taler direkte med BlogDrip.
Implementér automatiseret bestilling af gæsteindlæg
Forbind din interne arbejdsgang til de understøttede BlogDrip‑bestillingsoperationer. Et typisk flow: en ny kampagne oprettes i dit system → et website vælges (resolvér dets `marketSiteId` fra markedsplads-endpoints) → din applikation forbereder den nødvendige ordreinformation (title, URL, description, `categoryId`, `marketSiteId`, `campaignId`, valgfri `scheduleDate`, `linkNoFollow`) → backenden validerer ordren mod dine forretningsregler → applikationen indsætter ordren via Annonsør-API'en → responsen gemmes i dit system til sporbarhed. Validér hvert felt mod OpenAPI‑spec'en før afsendelse.
Håndter fejl og duplikerede ordrer
Validér forespørgsler før afsendelse, forhindre utilsigtede duplikerede ordrer (en idempotensnøgle eller en server-side de-duplication‑kontrol på din side er et sikkert mønster), log hver API-fejl med nok kontekst til senere fejlfinding, håndter midlertidige forbindelsesproblemer pænt, og respekter dokumenterede rate limits. En regel at indlejre: genforsøg aldrig automatisk en ikke‑idempotent ordreoprettelse uden eksplicit menneskelig eller systembekræftelse — et genforsøg på en ordre, du ikke så svaret for, skaber en dobbeltopkrævning.
Test din integration
Kør din integration mod et sandbox‑miljø, hvis et sådan er dokumenteret. Hvis der ikke er noget sandbox, test mod produktion med omhu — kør aldrig automatiserede tests, der opretter reelle betalte ordrer, uden eksplicit autorisation. Brug en dedikeret testkampagne med menneskelig review før den første automatiske ordre sendes, og begræns automatiserede testruns til en kort tilladelsesliste af websites, du har forudgodkendt til integrationstest.
Udrul og overvåg
Flyt legitimationsoplysningerne ind i din produktions secret store, tilføj overvågning for integrationsfejl og usædvanlige ordreindsendelsesmønstre, spor ordreindsendelsesresultater end‑to‑end, behold operationelle logs længe nok til at fejlfinde en to‑uger gammel hændelse, overvåg dit kontoforbrug så du ikke mister API-adgang ved at falde under €500 månedligt minimum, og hold øje med BlogDrip changelog for API‑opdateringer, der kan kræve vedligehold af integrationen.
Integrationsmønstre
Sådan ser en sund integration ud
Den autoritative kilde til eksekverbare eksempler er OpenAPI‑specifikationen på app.blogdrip.com/api/public/openapi.json og de menneskelæselige docs på /api/public/docs. Spec'en er det, din kode bør genereres eller tjekkes imod — ikke en landing‑page‑snippet, der kan blive forældet.
I praksis følger en ren integration ofte samme form. Et tyndt API‑klientmodul i dit foretrukne sprog — en wrapperfunktion per operation du har brug for — håndterer mekanikken: det sætter `x-client-id` og `x-client-secret` headers på hver forespørgsel, serialiserer request‑body'en, deserialiserer `{ data, pagination }`‑konvolutten på listeendpoints (0‑baseret paginering), og konverterer fejlresponser (`{ message }`) til exceptions, som din forretningslogik kan fange rent. Hver wrapper har mindst én test, der asserterer på den dokumenterede form, så et skemasignal kommer som en fejlet test før det rammer produktion. Først når modulet er stabilt, kobler du det på resten af din applikation — kampagne‑triggers, ordre‑køer, retry‑workers, rapportering.
Den sekvens holder integrationen auditerbar: din API‑klient er et lille, veltestet surface; alt andet taler med BlogDrip gennem den.
Bedste praksis
Hvad får en API-integration til at holde længe
Mønstre, der holder automatiserede systemer sunde længe efter lancering.
Idempotens fra starten
Behandl ordreoprettelse som kostbar og irreversibel. Duplikeringskontrol på din side inden forespørgslen går ud — aldrig efter.
Sikker håndtering af adgangsoplysninger
API‑legitimationsoplysninger hører hjemme i en secret manager, scoped per environment. Roter dem ved fratræden, ikke ved sikkerhedsbrud.
Struktureret logning
Hvert request + response‑par får et correlation ID. Fremtidige dig, der fejlsøger en gammel ordre, vil takke nutidige dig.
Rate‑limit‑bevidste klienter
Respektér de dokumenterede rate limits. En klient, der backing off pænt, skalerer længere end en, der forsøger aggressive retries.
Mennesket i løkken
Beskyt det første produktionskald bag en menneskelig godkendelse. Udvid automatiseringen først, når integrationen har vist sig stabil.
Overvågning af forbrug
Alert, når månedligt konto‑forbrug nærmer sig eller falder under €500. At miste API‑adgang midt i en kampagne gør ondt.
Ofte stillede spørgsmål
Hvem er BlogDrip API'en for?
Annonsørkonti, der vil forbinde deres egen software — et custom-dashboard, en SEO‑bureauplatform eller et internt CRM — til BlogDrips bestillingsarbejdsgang for gæsteindlæg. Typiske brugere er bureauer, der håndterer kampagner i stor skala, interne SEO‑teams, der integrerer med en eksisterende tech‑stack, og udviklere, der bygger operationelle værktøjer for en specifik kunde eller produkt.
Skal jeg være udvikler for at bruge API'en?
For at bygge selve integrationen: ja. API'en er et programmatisk interface — brug af den kræver at skrive kode eller samarbejde med en udvikler. Hvis du vil have de operationelle fordele uden integrationsarbejdet, dækker markedspladsens UI den samme bestillingsfunktionalitet manuelt.
Hvad kræves for adgang?
En aktiv BlogDrip‑konto, der bruger mindst €500 pr. måned i alt — både manuelle ordrer og API‑ordrer tæller mod tærsklen. API‑adgang deaktiveres automatisk, hvis din konto bruger mindre i en given måned. De €500 er en volumen‑tærskel, ikke et separat API‑abonnement.
Hvor findes API-dokumentationen?
Den officielle API‑dokumentation ligger på app.blogdrip.com/api/public/docs/index.html, med den maskinlæsbare OpenAPI‑specifikation på app.blogdrip.com/api/public/openapi.json. Begge beskriver autentificerings‑schemet, det fulde endpoint‑katalog under `/api/public/*`‑namespace'et, request‑ og response‑strukturer, pagineringsformat og fejlsvar. Betragt dem som sandhedskilden for din integration.
Hvor finder jeg mine API-legitimationsoplysninger?
I Mine indstillinger → API‑adgang på app.blogdrip.com/settings. Du får et `x-client-id` og et `x-client-secret`; begge skal med i hver autentificerede forespørgsel som HTTP‑headers. Secret'en vises én gang ved udstedelse eller rotation — kopier den straks til din secret manager, da den ikke kan hentes senere. Legitimationsoplysninger er per konto; håndtér dem som enhver anden hemmelighed og hold dem ude af versionskontrol.
Hvordan virker paginering på listeendpoints?
Listeendpoints pakker deres svar i en `{ data, pagination }`‑konvolut og bruger 0‑baseret paginering — send `?page=0` for første side, `?page=1` for anden osv. Pagination‑blokken i responsen fortæller, om der findes flere sider. Hvis du migrerer fra det gamle `/api/<path>`‑interface, er responssformen uændret — kun base‑stien flyttes til `/api/public/*`.
Understøtter API'en webhooks?
Tjek OpenAPI‑spec'en på app.blogdrip.com/api/public/openapi.json for den aktuelle liste af understøttede callback‑ eller event‑notifikationsmekanismer. Hvis en funktion ikke er listet, bygg din integration uden at antage, at den findes — polling af API'en på et eget skema er et sikkert fallback.
Findes der et sandbox-miljø?
Det autoritative svar står i den aktuelle API‑dokumentation. Hvis et sandbox er angivet, brug det til integrationstest. Hvis der ikke er et, må du ikke oprette reelle betalte ordrer under automatiseret test uden eksplicit autorisation — brug i stedet en dedikeret testkampagne og menneskelig review.
Kan API-ordrer bruge Instant Publishing?
Tilgængeligheden af Instant Publishing afhænger af, om det valgte website har en understøttet automatiseret publiceringsintegration (enten BlogDrip WordPress‑plugin'et eller en Bureau‑API‑forbindelse). Enhver ordre — API eller manuel — placeret på et egnet website kan få fordel af automatiseret publicering. Ikke alle websites på markedspladsen understøtter det, så din integration bør behandle publiceringstidspunktet som per‑website, ikke ensartet.
Hvad er forskellen mellem Annonsør‑API'en og Bureau‑API'en?
Annonsør‑API'en er for kunder, der vil automatisere bestilling af gæsteindlæg fra deres egen software. Bureau‑API'en er for eksterne bureauer, linkopbygningsplatforme og udgiver‑netværk, der vil forbinde deres eget inventory til BlogDrip og automatisere understøttet fulfillment. Begge står alene — brug af den ene kræver ikke den anden.
Hvad sker der, hvis jeg genforsøger en fejlet ordreoprettelse?
Hvis du ikke så et bekræftet svar, antag at den første forespørgsel muligvis lykkedes på serveren. Genforsøg aldrig automatisk en ikke‑idempotent ordreoprettelse. Tilføj en server‑side de‑dupliceringsnøgle, eller forespørg efter den muligvis oprettede ordre før du genforsøger — hvad end din arbejdsgang understøtter rent. Et genforsøg på en succesfuld‑men‑uset ordre skaber en dobbeltopkrævning.
Klar til at automatisere din linkopbygning?
Åbn API‑dokumentationen, generér dine legitimationsoplysninger, og begynd at bygge. Markedspladsen skalerer med din automatisering — ikke omvendt.