Statuscode
Ein Statuscode ist die dreistellige Zahl, mit der eine Antwort beginnt und die sagt, wie der Aufruf verlaufen ist, bevor irgendetwas anderes gelesen wird.
Ausführlicher
Die erste Ziffer ist die ganze Geschichte. Zweihundert-irgendwas heißt, es hat funktioniert. Dreihundert-irgendwas heißt, woanders nachsehen. Vierhundert-irgendwas heißt, der Aufruf selbst muss geändert werden, und fünfhundert-irgendwas heißt, die antwortende Maschine hat etwas zu beheben.
Der Rest der Nummer grenzt es ein, und die Antwort sagt meist in Worten, was die Nummer in Ziffern sagt. Ein Programm liest die Nummer; ein Mensch liest den Satz.
Was es an einem echten Dokument bewirkt
Eine erfolgreiche Anfrage antwortet mit zweihundert, und der Body dieser Antwort ist das PDF. Alles andere antwortet mit einem Satz, der nennt, was sie aufgehalten hat; es lohnt sich, ihn wörtlich in Ihr eigenes Protokoll zu schreiben.
Vierhundert heißt, die Beschreibung hat etwas verlangt, womit die Engine nichts anfangen konnte, vierhundertzwei heißt, die Anfrage verlangt etwas, das ein Lizenzschlüssel abdeckt, und das Konto hat keinen, und vierhundertdreizehn heißt, entweder der Body des Aufrufs überschritt die Größe, die der Dienst annimmt, oder das Dokument überschritt die erlaubte Seitenzahl.
Woher es kommt, und warum
Die Nummern wurden gewählt, als die erste Version des Protokolls geschrieben wurde, und ihre Gruppierung nach der ersten Ziffer war der Sinn: Ein Programm, das eine bestimmte Nummer nie gesehen hat, weiß trotzdem, ob es erneut versuchen, woanders nachsehen oder aufgeben soll.
Einige davon sind in die Alltagssprache eingegangen — der für eine Seite, die es nicht gibt, steht auf T-Shirts —, was etwas darüber sagt, wie lange eine gute Konvention hält.