Doffin API – slik henter du anbud automatisk

Doffin tilbyr et REST-basert API som gir programmatisk tilgang til kunngjøringsdata. APIet er åpent og gratis å bruke, nø som betyr at utviklere og bedrifter kan hente anbudsdata direkte inn i egne systemer uten å gå via nettleseren. Datæne er strukturert i henhold til eForms-standarden og inneholder alle feltene som er synlige i kunngjøringen på nettsiden.

Primærbrukerne av APIet er teknologibedrifter som bygger varslings- og analyse-løsninger, større bedrifter som ønsker å integrere anbudsdata i sine CRM- eller ERP-systemer, og forskere som analyserer mønster i offentlige innkjøp. For de fleste leverandører vil det imidlertid være mer effektivt å bruke en ferdigbygd løsning som Varsly fremfor å bygge og vedlikeholde en egenutviklet integrasjon.

Doffins API er basert på OData-standarden og lar deg filtrere kunngjøringer på en rekke parametere inkludert publiseringsdato, CPV-kode, oppdragsgiver-ID, land og kontraktstype. Et typisk kall kan se slik ut: du spesifiserer et tidsrom, én eller flere CPV-koder og et geografisk filter, og APIet returnerer alle matchende kunngjøringer i JSON- eller XML-format.

For sanntidsbruk bør du sette opp en polling-mekanisme som kaller APIet med jevne mellomrom – for eksempel hvert 15. minutt – og lagrer nye kunngjøringer i en lokal database. Husk å implementere deduplicering slik at du ikke prosesserer samme kunngjøring to ganger. API-kvoter og rate limits kan variere, så sjekk alltid den offisielle dokumentasjonen på Doffin for oppdaterte grenser.

Autentisering er ikke nødvendig for lesing av offentlige kunngjøringer, men det anbefales å identifisere seg med en User-Agent-header som beskriver applikasjonen din. Dette gjør det enklere for Doffin å håndtere unormal trafikk og kontakte deg dersom det oppstår problemer.

Rå API-data fra Doffin er maskinlesbare, men ikke nødvendigvis lettleste for mennesker. Et viktig steg er å bygge en pipeline som beriker datæne med tilleggsinformasjon: slå opp CPV-kodetekst fra den offisielle kodedatabasen, legg til kommunenavn basert på NUTS-koder, og parse frister til et standardisert datoformat. Dette gjør datæne langt mer brukbare.

Neste steg er relevansfiltrering. Med et rått datafeed vil du motta alle kunngjøringer fra Doffin, men de fleste er irrelevante for din bedrift. Bygg et filtreringslag som matcher kunngjøringer mot din bedriftsprofil basert på CPV-koder, geografi og nøkkelord. For mer avansert filtrering kan du bruke maskinlæring til å score relevans – dette er nøyaktig hva Varsly gjør internt for sine kunder. Les mer om hvordan automatisert anbudsvarsling fungerer.

En egenutviklet API-integrasjon gir full kontroll over datæne og prosesseringen. Du kan tilpasse logikken nøyaktig til bedriftens behov, integrere med interne systemer og bygge dashboards skreddersydd for din bransje. For teknologiselskaper som allerede har utviklerkapasitet og et spesifikt behov, kan dette være den riktige veien.

Ulempen er at det krever kontinuerlig vedlikehold. API-strukturen endres når Doffin oppdaterer sine systemer – slik som ved eForms-overgangen. Du må holde deg oppdatert på endringer, håndtere nedetid og feil i API-et, og implementere feilhåndtering og varsling dersom integrasjonen stopper. For de fleste bedrifter er total eierkostnad for en egenutviklet integrasjon vesentlig høyere enn å bruke en tjeneste som Varsly, der du kan registrere deg gratis og umiddelbart få tilgang til ferdig bearbeidede anbudsdata.