Vad är ett API? En enkel guide för appbyggare

Ett API (application programming interface) är ett definierat sätt för en programvara att be en annan om data eller att få den att göra något. Din app skickar en begäran i ett överenskommet format – "ge mig morgondagens bokningar", "debitera det här kortet 200 kronor", "sammanfatta den här texten" – och det andra systemet skickar tillbaka ett strukturerat svar. API:er är hur delarna i en app pratar med varandra, och hur din app använder externa tjänster som betalningar, e-post, kartor och AI.

Varför API:er spelar roll när du bygger med AI

Nästan varje användbar app består av delar som kommunicerar via API:er:

• Inuti din app anropar skärmarna i webbläsaren din egna backends API för att läsa och spara data.
• Utanför din app anropar din backend andra företags API:er: Stripe för att ta betalningar, en e-postleverantör för att skicka kvitton, en leverantör av AI-modeller för att generera text.

När du ber en AI-byggare att "ta emot betalningar" eller "lägg till en AI-sammanfattning" är det egentligen kod som anropar ett API den skriver. Att kunna grunderna hjälper dig att förstå vad AI:n behöver av dig (vanligtvis ett konto hos den tjänsten och en API-nyckel), var saker kan gå fel och vad de kommer att kosta.

En vardaglig jämförelse

Tänk på en restaurang. Du går inte in i köket och lagar mat. Du läser menyn, säger till servitören vad du vill ha på ett sätt som köket förstår, och servitören kommer tillbaka med din mat – eller säger att rätten är slut.

• Menyn är API-dokumentationen: en lista över vad du kan be om och hur.
• Servitören är API:et: det ena överenskomna sättet för förfrågningar att komma in och svar att komma ut.
• Köket är det andra systemet: du behöver inte veta hur det fungerar inuti.
• Din beställning är förfrågan; tallriken är svaret.

Köket kan byta ugnar och personal utan att påverka dig, så länge menyn är densamma. Det är det verkliga värdet med ett API: det låter två system arbeta ihop utan att något av dem behöver veta hur det andra är byggt.

Hur en webb-API-förfrågan fungerar

De flesta API:er du möter är webb-API:er som fungerar över HTTP, samma protokoll som din webbläsare använder. Varje förfrågan har några delar:

Och varje svar har:

JSON (JavaScript Object Notation) är ett enkelt textformat med namn och värden inom klammerparenteser. Det är standardsättet för webb-API:er att utbyta data.

REST: den vanligaste stilen

REST är en allmänt använd konvention för att utforma webb-API:er. Varje typ av sak får sin egen URL, och standardmetoder säger vad du gör med den. Så här kan ett REST-API för en bokningsapp se ut:

PUT finns också och ersätter konventionellt en hel post, medan PATCH bara ändrar de fält du skickar.

Statuskoder du oftast ser:

När din app går sönder är statuskoden ofta den snabbaste ledtråden. Ett 401 från en betalningsleverantör betyder oftast att API-nyckeln saknas eller är fel; ett 429 betyder att du anropar för ofta.

REST är inte den enda stilen – GraphQL och RPC-liknande API:er finns också – men REST är vad de flesta tjänster och AI-byggda backends använder.

Ett praktiskt exempel: en bokningsbekräftelse

När en kund bokar en klippning i en frisörsalongsapp kan flera API-anrop ske på en eller två sekunder:

1. Bokningssidan i webbläsaren skickar POST /api/bookings med tjänst, tid och kunduppgifter till din backend.
2. Din backend kontrollerar att tiden är ledig, sparar bokningen i databasen och returnerar 201 Created.
3. Din backend anropar en e-postleverantörs API med sin hemliga nyckel: "skicka den här bekräftelsen till lena@example.com."
4. Om det finns en handpenning ber din backend betalningsleverantörens API att skapa en utcheckningssession och skickar kunden dit.
5. Senare anropar betalningsleverantören din app för att säga att betalningen lyckades. Det omvända anropet är en webhook.

De första två stegen är ditt eget API mellan frontend och backend. Stegen 3–5 är tredjepartsAPI:er.

Vanliga termer förklarade

Vanliga misstag och missuppfattningar

• Att lägga hemliga nycklar i frontend. Allt i kod som körs i webbläsaren kan ses av vem som helst som besöker sidan. Hemliga nycklar måste stanna på servern, i miljövariabler eller hemligheter.
• Att klistra in nycklar i chatten. Chatthistoriken kan lagras. Använd din byggares hemlighetsfunktion i stället, och rotera alla nycklar du exponerat.
• Att anta att ett API är gratis. Många API:er tar betalt per förfrågan eller per användning – AI-modellers API:er tar betalt per token. Kontrollera priser och sätt spenderingsgränser. Se hur du använder LLM-API:er.
• Att inte hantera fel. Externa tjänster går ner, får timeouts och når gränser. Be om vettiga felmeddelanden och återförsök.
• Att lita på webbläsaren. Ditt eget API måste själv kontrollera behörigheter. Att gömma en knapp stoppar inte någon från att anropa slutpunkten direkt.
• Att använda live-nycklar under testning. Använd testlägesnycklar tills du är redo att lansera.

Vad du ska be din AI-byggare om

• "Vilka externa API:er använder den här appen, och vad kostar vart och ett?"
• "Anropa betalnings-API:et bara från servern. Läs nyckeln från en miljövariabel."
• "Lista varje slutpunkt i vårt API, vad den gör och vem som får anropa den."
• "Kontrollera på servern att den inloggade användaren äger bokningen innan den uppdateras eller tas bort."
• "Om e-post-API:et misslyckas, spara bokningen ändå och logga felet."
• "Använd leverantörens testläge för tillfället."

API:er i Mythex

Mythex kan bygga ditt eget API – som en del av en webbapp, eller som en separat backend i Node, Python (FastAPI), C# eller Java som körs tillsammans med din frontend – och skriva koden som anropar externa tjänster. Du lägger till deras nycklar som projekthemligheter snarare än i chatten, och de är tillgängliga för din app i förhandsvisningen och när den är publicerad. Docs har recept för att integrera vilket API som helst och att bygga en REST-API-backend.

Frågor