API Basics – Level 3 (Troubleshooting)

I Level 1 och 2 lärde du dig grunderna och hur API:er används i praktiken.

I denna nivå fokuserar vi på vanliga problem och hur du som first line kan hantera dem.

API Farm validerar automatiskt data (t.ex. postnummer, tjänster och format).

Det innebär att de flesta problem beror på fel eller saknad information i requesten.

Din roll är att:
– förstå vad felet betyder
– hjälpa kunden att felsöka
– avgöra när ärendet ska eskaleras

 

1. Shipment not created

Problem:
Shipment skapas inte

Possible reason:
– Saknad eller felaktig data
– Ogiltigt postnummer (validation error)
– Fel tjänst vald

What this means:
DHL kunde inte validera informationen i requesten och stoppar därför skapandet av shipment.

What to do:
– Be kunden kontrollera att alla fält är ifyllda
– Kontrollera postnummer och adress
– Kontrollera att rätt tjänst används

Escalate if:
– Alla värden är korrekta men shipment skapas fortfarande inte
– Felet är oklart

 

2. Error response received

Problem:
Kunden får en error response

Possible reason:
– Validation error
– Saknade fält
– Fel format på data

What this means:
API Farm har kontrollerat requesten och hittat ett fel i datan.

What to do:
– Be kunden kontrollera sitt felmeddelande
– Kontrollera att alla obligatoriska fält finns
– Be kunden testa igen efter korrigering

Escalate if:
– Felmeddelandet är otydligt
– Problemet kvarstår trots korrigering

 

3. Works in test but not in production

Problem:
Fungerar i test men inte i produktion

Possible reason:
– API inte aktiverat i produktion
– Fel API-nyckel
– Skillnader i data mellan test och produktion

What this means:
Kundens integration fungerar, men är inte korrekt aktiverad eller konfigurerad i produktionsmiljön.

What to do:
– Kontrollera att kunden har ansökt om produktion
– Kontrollera att rätt API key används
– Be kunden verifiera sina inställningar

Escalate if:
– Allt verkar korrekt men fungerar ändå inte
– Produktionsaktivering kan behövas

 

4. Incorrect or missing data

Problem:
Fel eller saknad data i request

Possible reason:
– Saknade obligatoriska fält
– Fel format
– Felaktiga värden

What this means:
Requesten uppfyller inte kraven och stoppas vid validation.

What to do:
– Be kunden kontrollera alla fält
– Säkerställ att rätt format används
– Kontrollera att alla värden är giltiga

Escalate if:
– Kunden är osäker på vilka värden som ska användas
– Problemet inte kan identifieras

 

5. When to escalate

Problem:
Osäkerhet kring hur problemet ska hanteras

Possible reason:
– Problemet kräver teknisk analys
– Oklart fel eller otydlig error response

What this means:
Ärendet behöver hanteras av integrationsteam eller second line support.

What to do:
– Samla så mycket information som möjligt från kunden
– Dokumentera vad som redan testats
– Skicka vidare ärendet

Escalate if:
– Problemet inte kan lösas med grundläggande felsökning

 

Next step

Du har nu en grundläggande förståelse för API:er och hur du hanterar vanliga problem.

Du kan använda denna guide som stöd i ditt dagliga arbete med kunder.