Hvor mye utviklertid sparer en bro mot norske offentlige API-er?

Hva koster engangsoppsettet?

Vårt planleggingsspenn for å sette opp Maskinporten pluss håndtrykket for systembrukerdelegering er 40 til 120 timer. Det dekker å skaffe og installere et virksomhetssertifikat, generere og laste opp et nøkkelpar, implementere den signerte klient-assertionen, registrere systemet, og bygge delegeringsflyten du tar kundene gjennom. Det forutsetter at du bygger dette til produksjonsstandard framfor til en demo, og det er mesteparten av forskjellen mellom de to endene av spennet.

I tillegg har hvert register du integrerer sitt eget spenn på 30 til 80 timer. Det forutsetter at autentisering allerede er løst av oppsettsarbeidet over, og det dekker skjemakobling, gjentakelser, feilhåndtering og en testsuite verdt å ha. Et prosjekt som berører tre registre ser derfor på oppsettsspennet pluss tre av registerspennene, og det er der et to ukers estimat stille blir til et kvartal.

Spennet er bredt fordi det bredeste inndataet ikke er teknisk. Utstedelse av sertifikat og godkjenning av bruksvilkår går på andre organisasjoners kalendere, så to like kompetente team kan lande i hver sin ende av grunner ingen av dem styrer. Vi vil heller publisere et spenn med antakelsene vedlagt enn ett tall som ser autoritativt ut og ikke er det.

Hva koster det løpende vedlikeholdet?

Vår utgangsantakelse er rundt 4 timer i måneden per integrasjon, og det er tallet det er verdt å diskutere fordi det er det som akkumulerer. En førstegangssammenligning smigrer det å bygge selv: oppsettskostnaden betales én gang og huskes, mens vedlikeholdet betales for alltid og glemmes. Over tre år er den løpende kolonnen som regel større enn byggekolonnen, og ingen legger merke til det fordi den kommer som spredte småoppgaver framfor som et prosjekt.

Hva som ligger i den: fornyelse av sertifikat og nøkkelrotasjon etter en plan, skjemaendringer oppstrøms som bryter tolkningen din, delegeringstilstander som endrer seg uten varsel, og den generelle driften i kode ingen har lest siden den ble levert. Kjører du delegeringer per klient over en kundemasse, skalerer den siste kategorien med kunder framfor med registre, og det er en annen vekstkurve enn byggeestimatet antydet.

Hva koster en bruddendring oppstrøms?

Den er ubudsjettert, og det er hele problemet med den. Et felt som får nytt navn i et registersvar er en liten rettelse, men den kommer uanmeldt, den lander på den som har vakt framfor på den som planla sprinten, og den oppdages av en kunde framfor av en test. Utviklertimene er sjelden den dyre delen; avbruddet og hendelsen er det.

Det strukturelle svaret er å legge den ustabile delen bak en versjonert kontrakt slik at endringer oppstrøms treffer et adapterlag framfor applikasjonskoden din. Det er verdt å gjøre enten du bygger eller megler, og veiledningen om fremtidssikring dekker hvordan du trekker den grensen.

For dine egne tall framfor våre tar kalkulatoren på sammenligningssiden for direkte integrasjon timeprisen og antall endepunkter og skriver hver antakelse ved siden av resultatet. Og det nøkkelløse sammenligningsendepunktet returnerer den samme sammenstillingen som strukturerte data, bevisst kvalitativ: de tidligere statiske tallene for suksessrate og responstid ble fjernet fordi de ikke kunne underbygges, som er den samme standarden denne siden holder seg selv til.

Gjør det første kallet

Sammenligningsendepunktet trenger ingen nøkkel. Les feltet methodology før dimensions: det sier hvordan sammenligningen ble laget, og det er den delen som forteller deg hvor mye vekt du skal legge på den.

# Nøkkelløst: den strukturerte sammenligningen, med metodefelt.
curl -s https://www.apier.no/api/v1/comparison/direct-integration

// Sammenligningen er kvalitativ med hensikt: den bærer ingen
// ikke-etterprøvbare tall for suksessrate eller responstid.
const res = await fetch(
  "https://www.apier.no/api/v1/comparison/direct-integration",
);

const { data } = await res.json();
console.log(data.methodology, data.source, data.last_updated);
for (const dimension of data.dimensions) {
  console.log(dimension);
}

Ofte stilte spørsmål

Hvor mange utviklertimer tar en direkte integrasjon?

Våre publiserte planleggingsspenn er 40 til 120 timer for engangsoppsettet av legitimasjon og 30 til 80 timer per register som integreres, med rundt 4 timer i måneden i vedlikehold som utgangsantakelse. Dette er grove estimatspenn framfor målinger, og de forutsetter et kompetent team som bygger noe produksjonsklart med gjentakelser, feilhåndtering og tester.

Hvorfor er oppsettsspennet så bredt?

Fordi det bredeste inndataet ikke er teknisk. Utstedelse av sertifikat og godkjenning av bruksvilkår går på andre organisasjoners kalendere, så to team med lik kompetanse kan lande i hver sin ende av spennet av grunner ingen av dem styrer. Et smalere tall ville vært en gjetning som ser mer presis ut, ikke en bedre en.

Hva består den løpende kostnaden av?

Fornyelse av sertifikat og nøkkelrotasjon, skjemaendringer oppstrøms som bryter tolkningen din, delegeringstilstander som endrer seg uten varsel, og den vanlige driften i en integrasjon ingen har sett på på et halvår. Ingenting av dette er synlig i et førstegangsestimat, og derfor pleier sammenligninger gjort ved prosjektstart å smigre det å bygge selv.

Kan dere gi meg en prissammenligning?

Ikke fra denne siden, og det er med vilje. Penger krever en timepris vi ikke har, og et gebyr vi måtte tillegge noen andre. Kalkulatoren på sammenligningssiden for direkte integrasjon tar din egen timepris og ditt antall endepunkter og gjør regnestykket med alle antakelser skrevet ved siden av resultatet.

Er disse tallene målt?

Nei. De er estimatspenn til planlegging, og vi merker dem slik framfor å presentere dem som telemetri. Det maskinlesbare sammenligningsendepunktet har samme holdning: det returnerer kvalitative dimensjoner og et metodefelt, og de tidligere statiske tallene for suksessrate og responstid ble fjernet nettopp fordi de ikke kunne underbygges.