? Hvis hver programmerer satte seg og lærte koden er nødvendig for å direkte manipulere og kontrollere alle aspekter av operativsystem, maskinvare og programvare -komponenter hans programmer usedm da ville han neppe har tid til å gjøre noen programmer av sine egne. Det er av denne grunn at programmerere gir programmeringsgrensesnitt for å utføre komplekse kode for å kommunisere med ulike maskinvare-og programvarekomponenter . Formål
APIer gi et standardisert sett med funksjoner for programvare og operativsystem for å samhandle med hverandre . Ved hjelp av et slikt grensesnitt gjør at en programmerer å fokusere sin tid på å skrive ny kode for romanen program , heller enn å skrive koden som andre programmerere allerede har skrevet . Ved å benytte et operativsystem API , betyr en programmerer ikke å reprodusere hardware interaksjoner , som vertssystemet allerede utfører . Ved å bruke en webtjeneste API , kan han bruke denne tjenesten til å utføre underliggende oppgaver å produsere data at hans program vil bruke til å gjøre noe nytt .
Public Facing Funksjoner
utviklere tilgang APIer ved å ringe en offentlig vendt funksjon. Hver API-funksjonen tjener et bestemt formål, for eksempel å hente informasjon om tilstanden til en bestemt del av maskinvaren eller utfører en får nye historier fra en RSS- feed. For hver API-funksjonen , har programmereren å gi visse opplysninger , også kalt argumenter, for at funksjonen skal fungere. Disse varierer fra funksjon til funksjon og kan inkludere data som brukernavn, passord , nettside navn eller noe annet API-funksjonen trenger for å utføre oppgaven programmerer ber om .
Private Funksjoner
Etter en programmerer kaller et offentlig -vendt API-funksjonen , er informasjonen han ga deretter gått inn i en rekke private tilstelninger som faktisk utfører koden nødvendig å samhandle med hardware komponent eller utføre software service er nødvendig å fullføre forespørselen . Resultatet av disse operasjonene blir deretter ført tilbake til det program som kalte den offentlige API- funksjon . Programmereren kan ikke direkte tilgang til disse private tilstelninger . Dette kan være fordi det koder som gjorde API ønsket å sikre at programmerere som vil bruke API ikke tilfeldigvis forårsaker koden ikke virker , eller fordi koden er nødvendig for å fullføre forespørselen er proprietære i naturen .
dokumentasjon
programmerere som lager APIer gi dokumentasjon som forteller andre programmerere hvordan å bruke API. Disse inkluderer en omfattende liste over alle API offentlige møter funksjoner og forklaringer på hva hensikten hver API-funksjonen fungerer . Dokumentasjonen vil også omfatte de argumentene som hver funksjon krever programmerer å passere i , og detaljer om formatet på dataene hvilke funksjoner som vil returnere når programmerer kaller dem .