Hvad står API for? Eksempler på hvordan man bruger API'er

API står for "Application Programming Interface". Og selvom dette måske lyder underligt, hvis du er ny til programmering, er de nemme at forstå, når du nedbryder det. Du bruger dem endda dagligt, mens du betjener din mobiltelefon, pc eller mens du surfer på internettet.

Software, inklusive webapps, mobilapps og mange andre programmer, forbinder verden sammen via internettet. Men for at gøre dette mere effektivt skal der være en kommunikationskanal mellem denne software - det er her, en API kommer ind.

Her forklarer vi betydningen af ​​API'er og hvordan de bruges.

Hvad er en API?

Ved du, hvordan du kan se videoer på streamingplatforme som blandt andet Netflix og YouTube? Det er muligt, fordi du sender en anmodning via en API.

Eller har du forestillet dig, hvordan du kan betale for de varer, du køber fra onlinebutikker som Amazon og eBay? Det skyldes også, at der er en kommunikationskanal kendt som en API mellem din bank og shoppingapps.

Når det er sagt, er en API en grænseflade med et sæt regler, der tillader din apps server at interagere med en løsningsudbyders server, så du kan bruge deres ressourcer. I det væsentlige definerer det, hvordan apps eller software kommunikerer med hinanden.

I nogle tilfælde tillader dog en API gensidig dataudveksling. Et eksempel er en forbindelse, der findes mellem dine bankapps og onlinebutikapps.

En API er som en messenger. Den opretter forbindelse til en udbyders server i den ene ende og forankrer også klientens server i den anden ende. Derefter udbydes klientens anmodning til datakilden (udbyderens server) og returnerer et svar til klienten. En klient her er browseren eller din app.

En krog vedhæfter dog din app til API'en. Det er et API-slutpunkt. Imidlertid udfolder mange ting sig bag scenen. Vi forklarer disse yderligere.

Hvordan API'er hjælper dig med at udvikle apps hurtigere

API'er er et smartere værktøj til opbygning af sømløse og robuste applikationer. Uden dem ville det tage aldre at bygge sofistikerede apps.

Forestil dig, at du har brug for din app til at udføre komplekse operationer, den type der tager masser af tid og kræfter at bygge. Og så dukker nogen op med et færdigt program, der gør præcis, hvad du vil, og muligvis bedre.

Men hvordan kan du forbinde dette til din app? Udbyderen, der indså dette, kan give dig noget hårdt og fortalte dig, at de oprettede en forbindelsesgrænseflade (API), der får deres kode og din til at integreres problemfrit.

Denne grænseflade (API) opretter forbindelse til serveren, der indeholder deres kode. Derefter føder det dig tilbage de relevante data fra handlingen af ​​deres script.

Selvfølgelig vil du ikke kede dig med hele deres kildeskript. Desuden er de fleste af de moderne API'er nu afhængige af standardiseret REST-teknologi (Representational State Transfer). Det gør dem meget skalerbare og nemme at integrere, uden at du behøver at bekymre dig om, hvad der udfolder sig inden for eller tilstanden af ​​dit svar eller din anmodning, når de er formateret.

Denne artikel går ikke nærmere, hvor REST API forklares. Fokuser på det grundlæggende indtil videre.

At tilslutte din kode til deres er en bedre idé end at skrive den fra bunden. For at gøre det skal du dog tilslutte din kode med den API, de har leveret. Hvordan gør du dette? Det er her, et API-slutpunkt kommer ind i scenen.

Hvad er et API-slutpunkt?

For at forenkle tingene anbragte udbyderne derefter en URL for at gøre forbindelsen til deres API problemfri. En sådan URL er en API-slutpunkt. Med det kan din app derefter få adgang til deres server via API'en og kommunikere direkte med deres script.

Så alt hvad du skal gøre er at få fat i slutpunktet, indsætte det i din kode, stille anmodninger med det, tilpasse svarene, og så fungerer det, og det er dit! Et API-slutpunkt binder derfor din app via en API til en løsning eller datakilde.

I sidste ende er mange af de programmer, der tilbyder API'er, tilgængelige på forskellige programmeringssprog, så ingen bliver udelukket fra at drage fordel af dem.

På den måde kommer du til at kode hurtigere og mere effektivt, idet du ved, at forpligtelsen til at vedligeholde API ikke kun er dig, men data- eller løsningsudbydere.

Derfor er et API-slutpunkt en kommunikationskrog, der binder en API til en ressource-server i den ene kant og forbinder den med modtagerens server i den anden ende.

Det betyder så, at du ikke har brug for hele scriptet til den løsning, du vil bruge. Men din kode kan ikke etablere kommunikation med den, hvis den ikke opretter forbindelse til API-slutpunktet.

API-integrationsregler

Der er ingen hård regel for integration af en API. Der er masser af dem derude, og hver af dem har sine integrationsregler. Men husk at du forventer en respons når du opretter en forbindelse med en API.

Hvordan du fremsætter anmodninger via et API-slutpunkt er normalt baseret på udbyderdefinerede regler, men hvad du gør med det svar, du får, afhænger af din præference. I det væsentlige kan du vride det, som du vil, for at være i overensstemmelse med din apps brugeres oplevelse og grænseflade.

Nogle gange har du også brug for en godkender, før du kan få adgang til en API. Sådanne godkendere kommer normalt som adgangstokener eller API-nøgler. Når dette token har bestået en godkendelsestest, signalerer API'et derefter sit slutpunkt for at etablere en forbindelse mellem din app og udbyderens server.

Som API-forbruger behøver du ikke bekymre dig om disse parametre, fordi API-udbyderen gør dem tilgængelige. En god API skal også angive, hvordan du kan få adgang til og bruge dets ressourcer i dens dokumentation. Så hold altid øje med det, når du prøver at integrere en.

For at afrunde det handler et API-opkald om overskrifter, en slutpunkt, det anmodning, og respons eller den legeme.

Mens vi har forklaret, hvad et slutpunkt er, lad os nedbryde disse andre vilkår yderligere:

Overskrifter

Normalt skal du beskrive to former for overskrifter, mens du opretter forbindelse til en API: anmodning og respons overskrifter.

Det anmodningsoverskrift er porten til et API-opkald. Det beskriver en klients tilgang til adgang til en ressource. Det muligvis detaljerer ting som acceptabel forbindelsestype, proxyoplysninger og den datatype (JSON, XML eller HTML), du ønsker at få fra API'et.

Som vi tidligere har beskrevet, afhængigt af hvilken type API du opretter forbindelse til, skal du muligvis også angive et unikt godkendelsestoken i anmodningsoverskriften. Udbyderen giver normalt dette.

Det svar headerpå den anden side er en påstand om de data, der kommer fra udbyderens server. Det giver din app oplysninger om en udbyders egenskaber. I det væsentlige sikrer det, at din app giver adgang til svaret, der kommer fra API'en.

API-anmodning

En API-anmodning indeholder normalt slutpunktet i en URL (Unique Resource Locator). Det bruger Hypertext Transfer Protocol (HTTP) til at finde adressen på den ressource, du prøver at få adgang til med en API. I sidste ende er en API-anmodning ikke komplet, hvis du ikke inkluderer slutpunktet i URL'en.

API-svar

Et svar er, hvad en API sender tilbage, hver gang den modtager en anmodning fra din app. Det kan være JSON, XML eller HTML afhængigt af de data eller indholdstype, det modtager fra din anmodningsoverskrift.

Når du først får svar fra en API, kan du betragte dit API-opkald som en succes.

Sådan bruges API'er: Praktiske eksempler

Nu hvor du kender det grundlæggende i API'er, og hvad du har brug for for at integrere en. Se på, hvordan du opretter forbindelse til og integrerer en fodboldforudsigelses-API fra RapidAPI ved hjælp af Python nedenfor.

Det er et simpelt API-opkald, der returnerer et JSON-svar. Du kan også skrive din kode ind enhver teksteditor, og kør det via kommandolinjen.

Relaterede: Sådan kører du dit Python-script

Vær dog opmærksom på slutpunktet, indholdet af anmodningsoverskrifterne og svaroverskrifterne:

importanmodninger
slutpunkt = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federation": "UEFA"}
#Definer anmodningshovedet:
overskrifter = {
'x-rapidapi-key': "Indsæt din adgangsnøgle her",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
#Definer svaroverskriften:
respons = anmodninger.forespørgsel ("GET", slutpunkt, overskrifter = overskrifter, params = forespørgsel)
#Få svaret:
udskriv (respons.tekst)

Fortsæt med at lære: Sådan bruges IPStack API til IP Geolocation-opslag

Hvad med at få den aktuelle temperatur og fugtighed på et sted ved hjælp af Weatherstack API med Python? Her er et eksempel nedenfor:

importanmodninger
slutpunkt = ' http://api.weatherstack.com/current'
overskrifter = {
"access_key": "Indsæt din adgangsnøgle her",
"forespørgsel": "Californien"
}
req = anmodninger.get (slutpunkt, overskrifter)
res = req.json ()
udskriv (u "Aktuel temperatur i% s er% d ℃"% 
(res ["placering"] ["navn"], res ["nuværende"] ["temperatur"]))
udskriv (u "Aktuel luftfugtighed i% s er% d ℃"% 
(res ["location"] ["name"], res ["current"] ["fugtighed"]))

Typer af API'er, som du kan integrere

Open source API'er er gratis, og alle kan bruge dem. Interne API'er findes i en organisation, og kun apps, der tilhører den organisation, kan bruge dens ressourcer.

Du kan dog også vælge en dedikeret API ved at indgå en partnerskabsaftale med en udbyder. Eller du kan kombinere flere API'er for at løse forskellige problemer.

Disse API'er, undtagen open source og interne API'er, kan også have en pris, som nogle gange varierer fra hundreder til tusinder af dollars.

Forenkle appudvikling med API'er

Som du kan se, at du ikke længere behøver at skrive tidskrævende kode. Hvis du har brug for din app til at udføre komplekse operationer, kan du altid søge derude og få fat i en relevant API. Heldigvis er de nu endda lette at integrere end gamle konventionelle. Og hvis du er nysgerrig og vil vide mere, er der mange gratis API'er derude, der kan hjælpe dig med at få dine hænder beskidte.

Hvordan API'er fungerer, og hvordan man integrerer dem i din app

Brug af applikationsprogrammeringsgrænseflader (API'er) er en vigtig færdighed for alle programmører at mestre.

Læs Næste

Om forfatteren