- Validera status, innehållstyp, struktur och betydelse innan data används.
- Sätta gränser för anslutning, svarsläsning, antal försök och total tid.
- Välja återförsök utifrån felklass, idempotens och återstående budget.
- Dokumentera och testa en felpolicy för ett eget IoT-flöde.
Ett svar är början på kontrollen
En gateway hämtar senaste temperaturen från ett API. Även när anropet får HTTP 200 kan svaret vara en HTML-sida, trasig JSON eller en mätning med fel enhet. Klienten behöver kontrollera varje gräns innan värdet används för visning eller styrning.
Börja med transporten: kom något HTTP-svar fram? Kontrollera därefter status, Content-Type, parsning, schema och semantik. Ett godkänt steg säger inget säkert om nästa steg.
- Transport: skilj anslutningsfel och timeout från mottagna HTTP-felsvar.
- Status: jämför den konkreta koden med API-kontraktet. 2xx anger framgång på HTTP-nivå; exempelvis 202 betyder att arbete har accepterats och 204 saknar svarskropp.
- Content-Type: kontrollera att svarets medietyp stöds av klienten. Förväntas JSON ska en HTML-sida avvisas.
- Parsning: fånga fel när svarskroppen tolkas som JSON.
- Schema: kontrollera obligatoriska fält och datatyper.
- Semantik: kontrollera enhet, rimliga värden och vid behov mätningens ålder.
Giltig JSON kan fortfarande vara fel data
Anta att kontraktet kräver sensorId som en icke-tom sträng, value som ett ändligt tal mellan −50 och 100 samt unit exakt C. En sträng som innehåller siffror är fortfarande fel typ för value. Ett tal på 170 går att parsa men bryter mot temperaturintervallet.
Ett sådant svar är ett kontraktsfel. Rapportera vilket fält och vilken regel som bröts. Skicka inte automatiskt fler identiska anrop i hopp om att valideringen ska lyckas.
HTTP/1.1 200 OK
Content-Type: application/json
{"sensorId":"temp-01","value":"21.7","unit":"C"}
Klientens beslut: avvisa svaret; value ska vara ett tal.Timeout lämnar utfallet öppet
När klienten slutar vänta kan servern redan ha sparat mätningen, fortfarande arbeta eller aldrig ha fått begäran. Timeout betyder därför okänt utfall. Att klienten avbryter sin väntan bevisar inte att serverarbetet avbröts.
Definiera fyra budgetar. Anslutningen och läsningen behöver egna gränser; hela operationen behöver dessutom en gemensam sluttid som omfattar samtliga försök och väntetider. Kontrollera vad tidsgränserna i ditt HTTP-bibliotek faktiskt omfattar.
- Anslutningstid: hur länge får ett försök etablera en anslutning?
- Svarsläsning: hur länge får klienten vänta på att läsa svaret?
- Antal försök: ange uttryckligen om första anropet räknas. Tre försök totalt betyder högst två återförsök.
- Total tid: stoppa när den gemensamma budgeten är slut och begränsa varje nytt anrop till återstående tid.
Välj återförsök utifrån fel och operation
Ett återförsök, retry, kräver tre ja: felet kan vara tillfälligt, operationen går att upprepa säkert och budgeten räcker. En viss statuskod ensam räcker inte som beslutsunderlag.
HTTP 400 med samma payload, 401 med samma token, 403 med samma behörighet och 404 på fel endpoint behöver normalt en ändring innan ett nytt anrop hjälper. Stoppa och ge begriplig återkoppling.
- Tillfälligt anslutningsfel: överväg nytt försök om operationen och budgeten tillåter det.
- 429: klienten skickar för många anrop; följ Retry-After när det finns.
- 502, 503 och 504: kan motivera begränsade återförsök.
- 500: kan vara tillfälligt, men kan också vara ett bestående programfel. Följ API:ts dokumenterade policy.
- Kontraktsfel efter 200: rapportera felaktigt svar; behandla det inte automatiskt som ett tillfälligt nätverksfel.
Idempotens och skydd mot dubbletter
Idempotens innebär att flera identiska anrop har samma avsedda effekt på servern som ett enda. GET är avsett för läsning. PUT och DELETE kan ändra tillstånd men är idempotenta enligt HTTP:s semantik. Svarskoden behöver inte vara densamma vid varje upprepning.
En POST som skapar en mätning kan skapa en dubblett om svaret försvinner och klienten skickar igen. Använd bara automatiska återförsök när API-kontraktet ger ett fungerande skydd, exempelvis en Idempotency-Key som servern hanterar. Samma logiska operation ska då återanvända samma nyckel och payload enligt kontraktet; en ny nyckel för varje försök ger inget dublettskydd.
Utan sådant stöd bör klienten rapportera det okända utfallet och, om API:t tillåter det, kontrollera om operationen redan utförts innan den skickas igen.
Vänta med backoff, jitter och Retry-After
Exponentiell backoff ökar väntetiden mellan försöken, exempelvis 100, 200 och 400 ms. Det är tre väntetider och högst fyra försök totalt. Lägg till slumpmässig variation, jitter, så att många klienter inte försöker igen samtidigt. Sätt ett tak för den egna backoff-väntan.
Retry-After kan ange sekunder eller ett HTTP-datum. Låt inte ett lokalt backoff-tak korta serverns angivna väntetid. Om väntan inte ryms i operationens totala budget ska klienten stoppa i stället för att försöka tidigare.
Exempelpolicy för GET /api/readings/latest
Anslutning: högst 500 ms per försök
Svarsläsning: högst 1 000 ms per försök
Försök: högst 3 totalt
Total budget: 4 000 ms, inklusive väntan
Egen backoff: 100, 200 ms + jitter 0–100 ms
Vänta minst Retry-After om servern anger det
Begränsa alltid anropet till återstående total tidFel som både program och människor kan förstå
Låt dokumenterade HTTP-statuskoder och stabila felkoder styra programmets beslut. En begriplig beskrivning hjälper användaren, men klienten ska inte behöva leta efter vissa ord i en fri feltext för att välja retry eller stopp.
Logga request_id, försöksnummer, felklass, väntetid och slutligt beslut. Vid anslutningsfel finns ingen HTTP-status att logga. Håll token, lösenord och privata nycklar borta från loggen, även när de är felaktiga.
{"code":"invalid_value","message":"value måste vara ett ändligt tal"}
{"request_id":"lab-11","attempt":2,"status":429,
"error_class":"rate_limit","wait_ms":1000,"decision":"retry"}Gör felpolicyn prövbar
Använd en lokal testtjänst där du kan välja svar och fördröjning. Kör normalfallet och ändra sedan ett villkor i taget: fel status, trasig JSON, fel datatyp eller för lång väntan. Dokumentera förväntat beslut innan du kör.
För varje scenario behövs observation, felklass, retrybeslut, antal försök och uppmätt totaltid. Ett lyckat omförsök är bara en del av resultatet: kontrollera även att klienten avbryter enligt budget och att en skrivoperation inte skapar dubbletter.
Prova själv
Ta med ämnet in i ditt eget IoT-case. Dokumentera vad du upptäcker.
- Välj ett IoT-case, exempelvis en gateway som hämtar senaste temperatur. Skriv ner kontraktet och policyn för de fyra budgetarna. Ange vilka operationer som får upprepas.
- Skapa minst sex dokumenterade scenarier i en lokal testtjänst: giltigt 200-svar, 400, 401, 503 följt av 200, 429 med Retry-After samt 200 med trasig JSON. Ange förväntad felklass och retrybeslut för varje scenario.
- Lägg till 200 med fel datatyp eller orimlig temperatur. Visa att klienten avvisar svaret innan mätningen används.
- Testa timeout och en Retry-After-väntan som är längre än återstående budget. Mät totaltiden och kontrollera att inga fler försök startas efter stoppbeslutet.
- Testa en POST där servern sparar men svaret fördröjs tills klienten får timeout. Verifiera dublettskydd enligt ditt API-kontrakt, eller dokumentera hur klienten hanterar okänt utfall utan ett blint återförsök.
- Samla loggar med request_id, försök, felklass, väntetid och slutbeslut. Kontrollera att hemligheter saknas. Jämför förväntat och faktiskt resultat och koppla den färdiga policyn till ditt IoT-case.
Testa dina kunskaper
Stanna upp en stund. Vad har fastnat?
Fortsätt vara nyfiken
Originalmaterial och utvalda källor för dig som vill gå djupare.
Föreläsningsbilder · Ämne 11Joakim Englund · Systementor AB · PDF på svenskaHTTP: idempotenta metoderIETF · RFC 9110 · EngelskaHTTP: Retry-AfterIETF · RFC 9110 · EngelskaHTTP 429: Too Many RequestsIETF · RFC 6585 · EngelskaEtt steg närmare helheten.
Markera ämnet när du känner dig redo.