API Basics – Level 1

Den här guiden ger en enkel introduktion till API:er och hur de används inom DHL.

Den är baserad på DHL API Farm – plattformen som används för att integrera kunders system med DHL Freight.

Målet är att du ska:
– förstå vad ett API är
– förstå vad en request och response är
– få en grund för att hantera enklare frågor från kunder

Som first line behöver du inte kunna bygga API:er – men du behöver förstå hur de fungerar för att kunna hjälpa kunder.

Du behöver inga tekniska förkunskaper.

 

When is this relevant for you?

Detta är relevant för dig när:

– En kund vill integrera via API
– En shipment inte skapas
– Du ser ett felmeddelande
– Du arbetar med onboarding av nya kunder

 

1. Why APIs matter (in DHL)

När en kund bokar en försändelse digitalt behöver system kommunicera med varandra.

Ett API gör det möjligt att skicka information direkt från kundens system till DHL via API Farm.

Exempel:
Ett kundsystem skickar bokningsinformation → DHL tar emot → en shipment skapas automatiskt

👉 API = hur system pratar med varandra

💡 I DHL används API:er för att skapa shipments, boka upphämtning och hämta information.

Vad är huvudsyftet med ett API?

A) Lagra data
B) Låta system kommunicera ✅
C) Skriva ut etiketter

 

2. What is an API?

Ett API kan ses som en “mellanhand” mellan två system.

Ett system skickar information.
Ett annat system tar emot och svarar.

I DHL:
Customer system → API → DHL system

👉 API = hur system pratar med varandra

Ett API fungerar som en mellanhand som skickar information mellan systemen.

📦 Tänk: API = en digital mellanhand som skickar bokningar till DHL

Vad gör ett API?

A) Sparar shipment-data
B) Skickar information mellan system ✅
C) Skapar användare

 

3. What is a request?

En request är den information som skickas till DHL via API.

Den innehåller t.ex:
– avsändare
– mottagare
– adress
– vald tjänst

Exempel:
“Create shipment from Stockholm to Gothenburg”

👉 Request = det kunden skickar in

📌 Scenario:
Kunden skickar en request utan postnummer → DHL kan inte skapa shipment

Vad är en request?

A) DHL:s svar
B) Information som skickas till DHL ✅
C) Ett felmeddelande

 

4. What is a response?

En response är svaret från DHL efter att en request har skickats.

Den visar om allt gick bra eller om något gick fel.

Exempel:
– Shipment created ✅
– Error ❌

📌 Scenario:
Om något saknas i requesten skickar DHL en response med ett felmeddelande

📥 Response = DHL:s svar tillbaka till kunden

Vad är en response?

A) Det kunden skickar
B) DHL:s svar ✅
C) En bokning

 

5. What can go wrong?

Ibland saknas information eller så är något fel i requesten.

Vanliga problem:
– Postnummer saknas
– Fel landkod
– Felaktig tjänst

📌 Scenario:
Customer sends request → missing postcode
→ DHL cannot create shipment
→ error response returned

⚠️ Fel uppstår oftast p.g.a. fel eller saknad data

Varför misslyckas en request oftast?

A) Systemet är för snabbt
B) Fel eller saknad data ✅
C) För många shipments

 

6. How it all works together

Så här ser flödet ut i API Farm:

1. Kunden skickar en request
2. DHL behandlar informationen
3. DHL skickar en response

Customer → API → DHL → Response

🔁 Request → Process → Response

Vilken ordning är korrekt?

A) Response → Request → Process
B) Request → Process → Response ✅
C) Process → Response → Request

 

Next step

Nu när du har förstått grunderna kan du gå vidare till nästa nivå:

👉 Level 2 – How APIs work in API Farm

Där går vi igenom hur API:er används i praktiken och hur onboarding av kunder fungerar.