Vad betyder API?

En API förkortning för Application Programming Interface betyder en uppsättning funktionskoder som tillåter applikationer att komma åt specificerade data och interagera med externa programkomponenter, operativsystem eller mikrotjänster.

För att förenkla, levererar ett API ett användarsvar till ett system och skickar systemets svar tillbaka till en användare. Du klickar på "lägg till i varukorgen;" ett API talar om för webbplatsen du lade till en produkt i din kundvagn; webbplatsen lägger produkten i din kundvagn och din varukorg uppdateras.

Du kanske hör termen "mikrotjänster" komma upp i relation till API. Dessa är dock inte desamma. Mikrotjänster är en stil eller arkitektur som delar upp funktionalitet inom en webbapplikation. Medan API är ramverket som utvecklare interagerar med en webbapplikation. Mikrotjänster kan faktiskt använda API för att kommunicera mellan varandra.

API låter en utvecklare ringa ett specifikt "samtal" eller "begäran" för att skicka eller ta emot information. Denna kommunikation sker med hjälp av ett programmeringsspråk som heter "JSON." Den kan också användas för att göra en definierad åtgärd som att uppdatera eller ta bort data. Det finns fyra grundläggande förfrågningsmetoder som kan göras med API:

GET – Samlar information (drar alla kupongkoder)

PUT – Uppdaterar bitar av data (uppdatering av produktpriser)

POST – Skapar (Skapa en ny produktkategori)

DELETE – (Ta bort ett blogginlägg)

Vad är JSON och varför används det?

JSON (JavaScript Object Notation) används för att representera data på en server. Det är ganska lätt att läsa av människor och lätt för maskiner/applikationer att förstå. Låt oss titta på ett exempel på JSON från en produkt på BigCommerce:

Detta är lätt att förstå eftersom det matas ut i nyckel/värdepar, med nyckeln till vänster och ett värde till höger. Nycklar är ett fast objekt som definieras av programmet och förblir detsamma som med "kategori". Medan värdena kommer att vara unika, som "skjortor".

Vad är en API-förfrågan?

Det finns flera komponenter i en API-förfrågan för att den ska fungera. Låt oss gå igenom dessa individuellt och hur de kan användas för att skapa en förfrågan.

Vad är Endpoint?

Det finns två nyckeldelar till en slutpunkt som används när man gör en API-förfrågan. En av dem är URL:en. BigCommerce använder https://api.bigcommerce.com/stores/ som URL för alla API-förfrågningar. Detta kan se ut som en vanlig URL, men om du kopplar in den till en webbläsare får du ett 404-felmeddelande.

Den andra delen är vägen. Vägen kommer att variera beroende på vad du försöker åstadkomma. Du kan hitta en lista över tillgängliga sökvägar för BigCommerce genom att besöka vår utvecklardokumentation: https://developer.bigcommerce.com/api-reference. För detta exempel kommer vi att använda produktsökvägen som är /v3/catalog/products.

När vi sätter ihop dessa två delar får vi en komplett slutpunkt https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products. Nu kanske du säger till dig själv "Vad är {store_hash}?" "Var kom det ifrån?" Detta är vad som kallas en variabel. Variabler är unika komponenter till en slutpunkt och kommer att variera beroende på din butiks information. Du kan se en variabel med de öppna och stängda parenteserna "{ }".

Vad är Header?

Rubriker ger information till klienten och servern. Vanliga exempel på en rubrik är autentiseringsuppgifter som ett "Auth Token" eller "Client ID". Dessa inloggningsuppgifter ges till dig automatiskt när du skapar ett API-konto. En annan vanlig rubrik kallas "Innehållstyp", som informerar servern om vilken typ av innehåll som kommer att skickas. Till exempel är en vanlig innehållstyp "application/json" som låter servern veta att vi skickar JSON-data över.

Vad är metod?

Metoder är de åtgärder som vidtas när du skickar en förfrågan. Tänk tillbaka på början när vi diskuterade GET, PUT, POST och DELETE. Dessa är alla API-metoder.

Vad är data?

Begäran data, även kallad "kropp", är information som antingen kommer att skickas till eller returneras av en server. I den tidigare diskussionen om JSON kan du se ett exempel på API-data. Brödtexten i en begäran kommer ibland att kräva specifik information innan den kan levereras. Ett exempel på detta är att om du redigerar en enskild produkt kommer produkt-ID att krävas innan någon ändring kan göras.

Läs mer här..