Vad står API för? Exempel på hur man använder API: er

API står för "Application Programming Interface". Och även om detta kanske låter konstigt om du är ny inom programmering, är de lätta att förstå när du bryter ner det. Du använder dem till och med dagligen när du använder din mobiltelefon, dator eller när du surfar på internet.

Programvara, inklusive webbappar, mobilappar och många andra program, länkar världen samman via internet. Men för att göra detta mer effektivt måste det finnas en kommunikationskanal mellan denna programvara - det är där ett API kommer in.

Här förklarar vi betydelsen av API: er och hur man använder dem.

Vad är ett API?

Vet du hur du kan se videor på streamingplattformar som bland annat Netflix och YouTube? Det är möjligt eftersom du skickar en begäran via ett API.

Eller har du föreställt dig hur du kan betala för de varor du köper från onlinebutiker som Amazon och eBay? Det beror också på att det finns en kommunikationskanal som kallas ett API mellan din bank och shoppingapparna.

Med detta sagt är ett API ett gränssnitt med en uppsättning regler som gör att din apps server kan interagera med en lösningsleverantörs server så att du kan använda deras resurser. I huvudsak definierar det hur appar eller programvara kommunicerar med varandra.

I vissa fall tillåter dock ett API ett ömsesidigt datautbyte. Ett exempel är en anslutning som finns mellan dina bankappar och webbutikappar.

Ett API är som en budbärare. Den ansluts till leverantörens server i ena änden och förankrar också klientens server i andra änden. Det anbudar sedan klientens begäran till datakällan (leverantörens server) och returnerar ett svar till klienten. En klient här är webbläsaren eller din app.

En krok fäster dock din app till API: et. Det är en API-slutpunkt. Men många saker utvecklas bakom scenen. Vi förklarar dessa ytterligare.

Hur API: er hjälper dig att utveckla appar snabbare

API: er är ett smartare verktyg för att bygga sömlösa och robusta applikationer. Utan dem skulle bygga sofistikerade appar ta åldrar.

Tänk dig att du behöver din app för att utföra komplexa operationer, den typ som det tar massor av tid och ansträngning att bygga. Och då dyker någon upp med ett färdigt program som gör exakt vad du vill, och möjligen bättre.

Men hur kan du ansluta detta till din app? Leverantören inser att detta kan ge dig lite svårt och sa sedan att de skapade ett anslutningsgränssnitt (API) som gör att deras kod och din integreras sömlöst.

Det gränssnittet (API) ansluter till servern som innehåller deras kod. Sedan matar den tillbaka relevanta data från handlingen i deras skript.

Naturligtvis vill du inte tråka dig ut med hela deras källskript. Dessutom är de flesta moderna API: er nu beroende av standardiserad REST-teknik (Representational State Transfer). Det gör dem mycket skalbara och enkla att integrera, utan att du behöver oroa dig för vad som utvecklas inom eller tillståndet för ditt svar eller din begäran när de är förformaterade.

Den här artikeln kommer inte längre att förklara REST API. Fokusera på grunderna för tillfället.

Att ansluta din kod till deras är en bättre idé än att skriva den från grunden. För att göra det måste du dock ansluta din kod till det API som de har tillhandahållit. Hur gör du det här? Det är där en API-slutpunkt kommer in på scenen.

Vad är ett API-slutpunkt?

För att förenkla saker sätter leverantörerna upp en URL för att göra anslutningen till deras API sömlös. Sådan URL är en API-slutpunkt. Med den kan din app sedan komma åt deras server via API: et och kommunicera med sitt skript direkt.

Så allt du behöver göra är att ta tag i slutpunkten, klistra in den i din kod, göra förfrågningar med den, anpassa svaren och sedan fungerar den, och den är din! En API-slutpunkt binder därför din app via ett API till en lösning eller datakälla.

I slutändan finns många av programmen som erbjuder API: er tillgängliga på olika programmeringsspråk så att ingen utesluts från att dra nytta av dem.

På det sättet får du koda snabbare och mer effektivt, med vetskap om att skyldigheten att upprätthålla API: t inte är på dig utan data- eller lösningsleverantörerna.

Därför är en API-slutpunkt en kommunikationskrok som binder ett API till en resursserver i ena kanten och ansluter den till mottagarens server i andra änden.

Det betyder då att du inte behöver hela skriptet för den lösning du vill använda. Men din kod kan inte skapa kommunikation med den om den inte ansluter till dess API-slutpunkt.

API-integrationsregler

Det finns ingen hård regel för att integrera ett API. Det finns massor av dem där ute, och var och en av dem har sina integrationsregler. Men kom ihåg att du förväntar dig en svar när du upprättar en anslutning med ett API.

Hur du gör förfrågningar via en API-slutpunkt baseras vanligtvis på leverantörsdefinierade regler, men vad du gör med svaret du får beror på dina preferenser. I grund och botten kan du vrida det när du vill överensstämma med appens användares upplevelse och gränssnitt.

Ibland behöver du också en autentiserare innan du kan komma åt ett API. Sådana autentiserare kommer vanligtvis som åtkomsttoken eller API-nycklar. När denna token klarar ett autentiseringstest signalerar API: et sin slutpunkt för att upprätta en anslutning mellan din app och leverantörens server.

Som API-konsument behöver du inte oroa dig för dessa parametrar eftersom API-leverantören gör dem tillgängliga. Ett bra API bör också ange hur du kan komma åt och använda dess resurser i dess dokumentation. Så se alltid upp för det när du försöker integrera en.

För att avrunda det handlar ett API-samtal om rubriker, ett slutpunkt, den begäran, och den svar eller den kropp.

Medan vi har förklarat vad en slutpunkt är, låt oss bryta ner dessa andra termer ytterligare:

Rubriker

Vanligtvis måste du beskriva två former av rubriker när du ansluter till ett API: begäran och den svar rubriker.

De begäran rubrik är porten till ett API-samtal. Det beskriver en klients inställning till tillgång till en resurs. Det kan innehålla detaljer som godtagbar anslutningstyp, proxyinformation och datatypen (JSON, XML eller HTML) du vill få från API: et.

Som vi beskrivit tidigare kan du, beroende på vilken typ av API du ansluter till, behöva tillhandahålla en unik autentiseringstoken också i begäran. Leverantören ger vanligtvis detta.

De svarsrubrik, å andra sidan, är ett påstående om data som kommer från leverantörens server. Det ger din app information om en leverantörs egenskaper. I grund och botten säkerställer den att din app ger åtkomst till svaret från API: et.

API-begäran

En API-begäran innehåller vanligtvis slutpunkten i en URL (Unique Resource Locator). Den använder HTTP (Hypertext Transfer Protocol) för att hitta adressen till den resurs du försöker komma åt med ett API. I slutändan är en API-begäran inte komplett om du inte inkluderar slutpunkten i URL: n.

API-svar

Ett svar är vad ett API skickar tillbaka varje gång det tar emot en begäran från din app. Det kan vara JSON, XML eller HTML, beroende på vilken data eller innehållstyp den får från din förfrågan.

När du har fått ett svar från ett API kan du anse att ditt API-samtal är framgångsrikt.

Hur man använder API: er: Praktiska exempel

Nu när du känner till grunderna i API: er och vad du behöver för att integrera en. Ta en titt på hur du ansluter och integrerar ett fotbollsprognos-API från RapidAPI med hjälp av Python nedan.

Det är ett enkelt API-samtal som returnerar ett JSON-svar. Du kan också skriva in din kod valfri textredigerare, och kör den via kommandoraden.

Relaterad: Hur du kör ditt Python-skript

Var dock noga med slutpunkten, innehållet i förfrågningsrubrikerna och svarsrubrikerna:

importförfrågningar
slutpunkt = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federation": "UEFA"}
# Definiera begäran rubrik:
rubriker = {
'x-rapidapi-key': "Klistra in din åtkomstnyckel här",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
# Definiera svarsrubriken:
response = requests.request ("GET", endpoint, headers = headers, params = queryparams)
# Få svaret:
skriva ut (respons.text)

Fortsätt lära: Hur man använder IPStack API för IP Geolocation Lookups

Vad sägs om att få den aktuella temperaturen och luftfuktigheten på en plats med Weatherstack API med Python? Här är ett exempel nedan:

importförfrågningar
slutpunkt = ' http://api.weatherstack.com/current'
rubriker = {
"access_key": "Klistra in din åtkomstnyckel här",
"fråga": "Kalifornien"
}
req = requests.get (slutpunkt, rubriker)
res = req.json ()
skriv ut (u "Aktuell temperatur i% s är% d ℃"% 
(res ["location"] ["name"], res ["current"] ["temperature"]))
skriv ut (u "Aktuell luftfuktighet i% s är% d ℃"% 
(res ["location"] ["name"], res ["current"] ["fuktighet"]))

Typer av API: er som du kan integrera

Öppna källkods-API: er är gratis och vem som helst kan använda dem. Interna API: er finns i en organisation, och endast appar som tillhör den organisationen kan använda dess resurser.

Du kan dock också välja ett dedikerat API genom att ingå ett partnerskapsavtal med en leverantör. Eller så kan du kombinera flera API: er för att lösa olika problem.

Dessutom kan dessa API: er, exklusive API: er för öppen källkod och interna, ha ett pris, ibland från hundratals till tusentals dollar.

Förenkla apputveckling med API: er

Som du kan se, att du inte behöver skriva tidskrävande kod längre. Om du behöver din app för att utföra komplexa operationer kan du alltid söka där ute och ta ett relevant API. Tack och lov är de nu till och med lätta att integrera än gamla konventionella. Och om du är nyfiken och vill veta mer finns det många gratis API: er där ute som kan hjälpa dig att smutsa händerna.

Hur API: er fungerar och hur man integrerar dem i din app

Att använda applikationsprogrammeringsgränssnitt (API) är en viktig färdighet för alla programmerare att bemästra.

Läs Nästa

Om författaren