HTTP-statuskoder

Vad sidan HTTP-statuskoder erbjuder

HTTP-statuskoder är ett sökbart uppslagsverk för svarskoder i intervallet 100 till 599. Det hjälper vid felsökning av API-anrop, när du skriver dokumentation, väljer svar för en ny endpoint, läser loggar, granskar en gateways beteende eller förklarar ett fel för en annan utvecklare. Varje post innehåller den numeriska koden, reason phrase, kategorin och en kort beskrivning av vad svaret vanligtvis betyder. Filtret matchar koder, namn, kategorier och beskrivningar, så du kan söka på exakta värden som 404, breda grupper som redirect eller begrepp som cache, auth, proxy, timeout och validering.

Listan är inbäddad direkt i sidan i stället för att hämtas från en tjänst, vilket gör den snabb och tillgänglig även när du arbetar offline eller felsöker nätverksproblem. Ett klick på ett resultat kopierar koden och frasen, vilket gör det enkelt att klistra in dem i ärendekommentarer, dokumentation, tester eller endpoint-anteckningar.

Privat arbetsflöde i webbläsaren

All bearbetning sker i din webbläsare med JavaScript på klientsidan. Verktyget laddar inte upp kodsnuttar, konfigurationsvärden, genererade data, frågetexter eller kopierade exempel till någon server och kräver inget konto. Den rent lokala modellen är viktig för utvecklarverktyg, eftersom innehållet som klistras in ofta liknar verkliga applikationsdata: API-svar, loggar, exempel i stil med miljövariabler, databasfrågor, uppmärkning från utkast eller värden kopierade från felsökning i produktion. Att hålla omvandlingen lokal minskar risken och gör interaktionen snabb eftersom ingen nätverksrunda behövs.

Gränssnittet är medvetet kompakt så att du kan klistra in indata, justera alternativ, granska utdata, kopiera den och gå tillbaka till din redigerare. Resultaten bör ändå granskas innan de committas, delas offentligt eller används i ett produktionsflöde. Webbläsarverktyg är utmärkta för snabb inspektion och förberedelse, men de kan inte känna till varje projektkonvention, dataklassificeringsregel eller applikationsspecifikt valideringskrav.

Praktiska tips

Statuskoder är en del av ett API:s kontrakt, så välj dem med omsorg. Använd svar i 400-serien när klienten kan ändra förfrågan, svar i 500-serien när servern inte kunde uppfylla en giltig förfrågan och svar i 300-serien när klienten bör leta någon annanstans. Fel vid autentisering och auktorisering förväxlas ofta: 401 betyder vanligtvis att autentisering krävs eller är ogiltig, medan 403 betyder att den autentiserade anroparen inte har behörighet. Kombinera koden med ett schema för svarskroppen och vägledning för åtgärder när du dokumenterar API:er.