Kort fortalt: En API er en aftalt grænseflade, hvorigennem softwaresystemer udveksler forespørgsler og data. Dokumentationen definerer operationer, input, output, godkendelse og begrænsninger.
Sådan bruger jeg en API i praksis
Jeg adskiller en API-prototype fra en produktionsproces. En prototype verificerer nytten; produktion kræver tilladelser, begrænsninger, overvågning og en fallback. Jeg betragter ikke et output som et faktum, blot fordi det lyder overbevisende, og jeg sporer vigtige påstande tilbage til den oprindelige kilde.
Det skal du holde øje med
Den største risiko er at automatisere en uklar proces. API'en producerer så inkonsistente resultater hurtigere og gør fejl sværere at spore. Vær opmærksom på følsomme data, ukendte tjenestebetingelser og beslutninger, der ikke let kan omgøres.
Spørgsmål til beslutninger
- Hvilken afgrænset opgave skal teknologien forbedre?
- Hvilke data må bruges, og hvem kontrollerer outputtet?
- Hvordan måler vi nøjagtighed og omkostning på virkelige sager?
- Hvordan stopper eller omgør vi processen efter en fejl?