Soms zit je in een keten van bewerkingen waarbij alles op elkaar leunt. Denk aan een API-request dat pas mag doorgaan als een andere actie is gelukt. En dan ineens krijg je deze terug: 424 Failed Dependency.
De server zegt hiermee eigenlijk: ik kon dit verzoek niet uitvoeren omdat iets anders, waar dit van afhing, niet werkte. Dus niet jouw fout, niet per se iets stuk, maar wel een duidelijke blokkade in de ketting.
Waar komt de 424 status code vandaan?
Oorspronkelijk is deze statuscode onderdeel van WebDAV, een protocol waarmee je meerdere bewerkingen op bestanden tegelijk kunt uitvoeren. Bijvoorbeeld: maak een map aan, voeg een bestand toe, stel rechten in. Als stap één mislukt, heeft stap twee geen zin. Dat idee is precies wat de 424 moet overbrengen.
Inmiddels zie je de 424 status code ook bij API’s die werken met transacties, afhankelijkheden of batchverzoeken. Eén actie faalt, dus de volgende wordt automatisch overgeslagen.
Een voorbeeld uit het echte leven
Stel: je stuurt een POST om een gebruiker aan te maken, gevolgd door een PATCH om direct iets aan die gebruiker te wijzigen. Als de aanmaak mislukt (bijvoorbeeld omdat het e-mailadres al bestaat), dan faalt die PATCH, en daar krijg je dus een 424 op terug.
Niet omdat je PATCH onjuist was, maar omdat de voorwaarde (die gebruiker moet bestaan) niet werd vervuld.
Hoe los je dit op?
Dit soort fouten los je niet op door te sleutelen aan het tweede verzoek. Je moet terug naar de stap die eraan voorafging. Waar ging het mis? Welke voorwaarde werd niet gehaald? Is de resource überhaupt aangemaakt? Of werkte een afhankelijk script, trigger of transactie niet zoals verwacht?
De foutmelding zelf geeft meestal niet alles prijs. Je zult moeten graven: logs, debug output, response codes van eerdere stappen.
Werk je in een microservice-omgeving of een architectuur met queues, dan kom je deze statuscode ook intern wel eens tegen. In dat geval is het vaak een gevolg van een dependency failure op systeemniveau.
Kort samengevat
De 424 status code is een signaal dat jouw verzoek op zich goed was, maar onmogelijk uit te voeren omdat een eerdere stap faalde.
Het is geen syntaxprobleem, geen autorisatiefout, en ook geen servercrash. Het is een afhankelijkheidsfout. De oplossing ligt dan ook meestal niet in het huidige request, maar in het traject dat eraan voorafging. Zodra je die oorzaak hebt gevonden en verholpen, zal de 424 vanzelf verdwijnen.
