API Basics – Level 2

I Level 1 lärde du dig grunderna om API:er.

I denna nivå fokuserar vi på hur API:er används i praktiken i DHL API Farm.

Målet är att du ska:
– förstå hur ett API används i ett riktigt flöde
– känna igen vanliga delar i en request
– förstå hur kunder använder API:er vid onboarding

Den här nivån hjälper dig att bättre förstå kunders frågor och hur integrationen fungerar i praktiken.

 

1. API in practice (API Farm)

I DHL används API:er via API Farm för att integrera kunders system med DHL.

Det innebär att kunder kan:
– skapa shipments
– boka upphämtning
– hämta information

Allt sker automatiskt genom att deras system skickar requests till DHL.

💡 API Farm = plattformen där integrationen sker

Exempel på API:er i API Farm:

– TransportInstruction API – skapa shipment
– Print API – skapa etiketter
– PickupRequest API – boka upphämtning

Vad används API Farm till?

A) Lagra kunddata
B) Integrera kunders system med DHL ✅
C) Skapa användare

 

2. A shipment flow (step by step)

Så här ser ett vanligt API-flöde ut:

1. Kunden skapar en request i sitt system
2. Requesten skickas till DHL via API Farm
3. DHL behandlar informationen
4. DHL skickar tillbaka en response
5. Shipment skapas

Customer system → API Farm → DHL → Response

🔁 Samma flöde som i Level 1 – men här sker det i verkligheten

Vad händer efter att kunden skickat en request?

A) DHL skickar direkt en faktura
B) DHL behandlar informationen och skickar en response ✅
C) Ingenting händer

 

3. What is inside a request?

En request innehåller den information DHL behöver för att skapa en shipment.

Vanliga delar:
– Avsändare
– Mottagare
– Adress
– Postnummer
– Tjänst (service)

📌 Scenario:
Om en kund väljer fel tjänst → shipment kan inte skapas

📤 En request består av flera fält som måste vara korrekta

Vad är viktigast i en request?

A) Att den är lång
B) Att alla nödvändiga fält är korrekta ✅
C) Att den skickas snabbt

 

4. Validation – why it matters

När DHL tar emot en request kontrolleras informationen.

Detta kallas validation.

Systemet kontrollerar till exempel:
– att alla obligatoriska fält finns
– att värden är korrekta

📌 Scenario:
Postnummer saknas → request stoppas → error response

💡 Validation sker innan shipment skapas

Om något är fel:
→ DHL stoppar requesten
→ en error response skickas tillbaka

⚠️ Validation = kontroll av data innan shipment skapas

Vad är validation?

A) Skapande av shipment
B) Kontroll av data innan behandling ✅
C) Skicka response

 

5. Common mistakes

Vanliga problem i API-integrationer är:

– Saknade värden
– Felaktiga värden
– Fel tjänst
– Fel format på data

📌 Scenario:
Fel landkod → DHL kan inte behandla requesten

⚠️ De flesta problem beror på data – inte på systemet

Vad är den vanligaste orsaken till problem?

A) Systemfel
B) Fel eller saknad data ✅
C) För många användare

 

6. API in onboarding

När en ny kund ska börja använda API sker en onboarding.

Det innebär att kunden:
– får tillgång till API Farm
– testar sina requests
– validerar att allt fungerar

💡 First line är ofta första kontakt i denna process

📌 Example onboarding flow:

1. Kunden registrerar sig i API Farm
2. Kunden får en API key
3. Kunden testar sina requests i testmiljö
4. Kunden skickar en implementation request
5. DHL aktiverar produktion

💡 Viktigt:

API:er testas först i en testmiljö (sandbox).

När allt fungerar:
→ kunden ansöker om produktion
→ DHL aktiverar API:et

Problem uppstår ofta när något fungerar i test men inte i produktion.

Vad gör kunden under onboarding?

A) Installerar DHL manuellt
B) Testar och validerar sina requests ✅
C) Skapar fakturor

 

7. Common situations you will encounter

Vanliga situationer du kommer stöta på:

– Kunden får error response
– Shipment skapas inte
– Test fungerar men inte produktion
– Fel tjänst används

👉 Ofta beror detta på fel eller saknad data

 

8. Your role as first line

Som first line behöver du inte lösa tekniska problem.

Men du ska kunna:
– förstå vad kunden försöker göra
– känna igen vanliga problem
– ställa rätt frågor

👉 Saknas någon information i requesten?
👉 Vilken tjänst används?
👉 Får kunden ett felmeddelande?

💡 Din roll = förstå problemet och guida vidare

Vad är din roll som first line?

A) Lösa alla tekniska problem
B) Förstå problemet och guida vidare ✅
C) Bygga API:er

 

Next step

Nu har du förstått hur API:er används i praktiken.

Nästa steg:

👉 Troubleshooting – vanliga problem och hur du hanterar dem