Τεχνική αναφορά

Κωδικοί κατάστασης απάντησης HTTP

Οι κωδικοί κατάστασης HTTP είναι τριψήφια σήματα σε μια απάντηση διακομιστή. Το πρώτο τους ψηφίο προσδιορίζει το ευρύ αποτέλεσμα· τα υπόλοιπα ψηφία προσδιορίζουν μια συγκεκριμένη κατάσταση. Αυτός ο οδηγός εξηγεί τους καταχωρημένους τυπικούς κωδικούς με πρακτικό πλαίσχο, καθώς και αξιοσημείωτες τιμές ειδικές για τον πάροχο που ενδέχεται να εμφανιστούν στα αρχεία καταγραφής.

Πώς να διαβάσετε αυτόν τον κατάλογο: Μια κατάσταση δεν είναι μια πλήρης διάγνωση από μόνη της. Ελέγξτε τη μέθοδο αιτήματος, τις κεφαλίδες απόκρισης, το σώμα, τον στόχο ανακατεύθυνσης και τον διακομιστή ή τον διακομιστή μεσολάβησης που το δημιούργησε. Οι μη αναγνωρισμένες τιμές διατηρούν γενικά το νόημα της πρώτης ψηφιακής κατηγορίας τους, αλλά η ακριβής συμπεριφορά τους μπορεί να είναι συγκεκριμένη για την υλοποίηση.

Συμβατότητα προγραμμάτων περιήγησης και χειρισμός απαντήσεων

Οι κωδικοί κατάστασης HTTP αποτελούν μέρος του πρωτοκόλλου HTTP, όχι χαρακτηριστικό προγράμματος περιήγησης που κάθε προμηθευτής υλοποιεί ως ξεχωριστό web API. Τα τρέχοντα πρόγραμμα περιήγησης μπορούν να χειριστούν τις τυπικές κλάσεις απόκρισης· οι ορατές σελίδες σφαλμάτων και η συμπεριφορά επανάληψης είναι συγκεκριμένες για το πρόγραμμα περιήγησης. Η υποστήριξη για νεότερες ενδιάμεσες απαντήσεις και εξειδικευμένες επεκτάσεις μπορεί να διαφέρει ανάλογα με την έκδοση και τη διαδρομή δικτύου.

Οικογένεια απάντησηςChrome / EdgeFirefoxSafariOperaAndroid / iOS WebViewΣημείωση συμβατότητας
1xx Ενημερωτικά (Informational)Υποστηρίζεται ως ενδιάμεσες απαντήσεις πρωτοκόλλουΥποστηρίζεται ως ενδιάμεσες απαντήσεις πρωτοκόλλουΥποστηρίζεται ως ενδιάμεσες απαντήσεις πρωτοκόλλουΥποστηρίζεται ως ενδιάμεσες απαντήσεις πρωτοκόλλουΥποστηρίζεται από τη στοίβα δικτύου χαμηλότερου επιπέδουΟι 100/101 είναι καθιερωμένοι· το 102 είναι εξειδικευμένο/υπό κατάργηση (deprecated). Η υιοθέτηση του 103 Early Hints και η παρατηρήσιμη συμπεριφορά προφόρτωσης διαφέρουν ανάλογα με την έκδοση του προγράμματος περιήγησης, τον διακομιστή και τον ενδιάμεσο.
2xx Επιτυχία (Success)ΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΟι τυπικές σημασιολογίες επιτυχίας κοινοποιούνται. Οι κανόνες σώματος εξακολουθούν να έχουν σημασία: για παράδειγμα, οι 204 και 205 δεν έχουν σώμα απάντησης.
3xx Ανακατεύθυνση (Redirection)ΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΗ τοποθεσία, η μέθοδος, η προσωρινή μνήμη και η πολιτική ασφαλείας επηρεάζουν την πλοήγηση. Οι 301/302 ενδέχεται να αλλάξουν το POST σε GET· οι 307/308 διατηρούν τη μέθοδο.
4xx Σφάλμα πελάτη/αίτησης (Client/Request Error)ΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΤο πρόγραμμα περιήγησης λαμβάνει την απάντηση· το αν εμφανίζει το σώμα του διακομιστή ή μια προβολή σφάλματος που δημιουργείται από το πρόγραμμα περιήγησης διαφέρει ανάλογα με την κατάσταση και το προϊόν.
5xx Σφάλμα διακομιστή (Server Error)ΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΥποστηρίζεταιΟι πελάτες μπορούν να επεξεργαστούν την κλάση απάντησης, αλλά οι σελίδες που δημιουργούνται από διαμεσολαβητή (proxy), η συμπεριφορά επανάληψης και η διαγνωστική διεπαφή χρήστη δεν είναι πανομοιότυπες σε όλα τα προγράμματα περιήγησης.
Άγνωστος κωδικός σε γνωστή κλάσηΧειρισμός σε επίπεδο κλάσηςΧειρισμός σε επίπεδο κλάσηςΧειρισμός σε επίπεδο κλάσηςΧειρισμός σε επίπεδο κλάσηςΧειρισμός σε επίπεδο κλάσηςΟι πελάτες HTTP μπορούν να συμπεράνουν τη γενική κλάση από το πρώτο ψηφίο· μην βασίζεστε σε έναν προσαρμοσμένο κωδικό που έχει τυπική σημασιολογία ή πανομοιότυπη διεπαφή χρήστη.

Η συμβατότητα εδώ περιγράφει τον χειρισμό σε επίπεδο πρωτοκόλλου, όχι την εγγύηση ότι κάθε πρόγραμμα περιήγησης εμφανίζει την ίδια σελίδα σφάλματος. Παλαιότεροι πελάτες, ενσωματωμένα WebViews, διαμεσολαβητές και δεσμευμένες πύλες (captive portals) ενδέχεται να επιβάλουν πρόσθετη συμπεριφορά.

1xx — Ενημερωτικές απαντήσεις

100

Continue (Συνέχεια)

Ο διακομιστής έχει αποδεχτεί τις κεφαλίδες αίτησης και περιμένει το υπόλοιπο σώμα αίτησης. Συνήθως χρησιμοποιείται με το Expect: 100-continue, ώστε ένας πελάτης να αποφύγει τη μεταφόρτωση ενός μεγάλου σώματος όταν η αίτηση πρόκειται να απορριφθεί.

Λειτουργική καθοδήγηση: Ενδιάμεση απάντηση; συνεχίστε να στέλνετε το σώμα μόνο όταν αναμένεται.

101

Switching Protocols (Αλλαγή πρωτοκόλλων)

Ο διακομιστής συμφωνεί να αλλάξει το πρωτόκολλο για αυτή τη σύνδεση αφότου ο πελάτης ζητήσει αναβάθμιση. Οι χειραψίες WebSocket είναι μια γνώριμη χρήση.

Λειτουργική καθοδήγηση: Μετάβαση σε επίπεδο Connection. επαληθεύστε τις κεφαλίδες Upgrade και Connection.

102

Processing (Επεξεργασία)

Ένας διακομιστής WebDAV αναφέρει ότι έχει ξεκινήσει μια χρονοβόρα λειτουργία αλλά δεν έχει ολοκληρωθεί. Είναι μια παλαιότερη/υπό κατάργηση (legacy/deprecated) απάντηση και δεν πρέπει να συγχέεται με το τελικό αποτέλεσμα.

Λειτουργική καθοδήγηση: Ενδιάμεση κατάσταση WebDAV. περιμένετε την τελική απάντηση.

103

Early Hints (Πρόωρες υποδείξεις)

Ο διακομιστής στέλνει προκαταρκτικές κεφαλίδες, συχνά υποδείξεις συνδέσμων, ενώ προετοιμάζει την τελική απάντηση. Ένας πελάτης μπορεί να αρχίσει να ανακτά πιθανώς κρίσιμα στοιχεία νωρίς.

Λειτουργική καθοδήγηση: Ενδιάμεση βελτιστοποίηση; πρέπει να ακολουθήσει μια τελική απάντηση.

2xx — Επιτυχείς απαντήσεις

200

OK (Εντάξει)

Η αίτηση ήταν επιτυχής. Η αναπαράσταση εξαρτάται από τη μέθοδο: το GET επιστρέφει τον πόρο, το HEAD επιστρέφει μεταδεδομένα χωρίς σώμα, και μια ενέργεια εγγραφής μπορεί να επιστρέψει μια αναπαράσταση αποτελέσματος.

Λειτουργική καθοδήγηση: Χρησιμοποιήστε το για ένα ολοκληρωμένο αίτημα με αναπαράσταση απάντησης όταν χρειάζεται.

201

Created (Δημιουργήθηκε)

Η αίτηση ολοκληρώθηκε και δημιούργησε έναν ή περισσότερους πόρους. Η απάντηση πρέπει να προσδιορίζει τον νέο πόρο, συνήθως με το Location, και μπορεί να επιστρέψει την αναπαράστασή του.

Λειτουργική καθοδήγηση: Τυπικό μετά από POST ή PUT. βεβαιωθείτε ότι μπορεί να εντοπιστεί ο δημιουργημένος πόρος.

202

Accepted (Έγινε αποδεκτό)

Ο διακομιστής αποδέχτηκε την αίτηση για επεξεργασία, αλλά η επεξεργασία δεν έχει τελειώσει και μπορεί ακόμα να αποτύχει. Το HTTP δεν παραδίδει αργότερα δεύτερη απάντηση για την ίδια ανταλλαγή.

Λειτουργική καθοδήγηση: Παρέχετε μια λειτουργία/κατάσταση URL ή άλλο τρόπο για να μάθετε το τελικό αποτέλεσμα.

203

Non-Authoritative Information (Μη αυθεντικές πληροφορίες)

Ένας μετασχηματιστικός διαμεσολαβητής (proxy) ή ενδιάμεσος επέστρεψε μεταδεδομένα ή περιεχόμενο που διαφέρει από την απάντηση προέλευσης. Αυτό σηματοδοτεί ότι η απάντηση δεν είναι άμεση αυθεντική αναπαράσταση.

Λειτουργική καθοδήγηση: Χρησιμοποιήστε μόνο όταν ένας ενδιάμεσος μετασχηματισμός είναι σχετικός.

204

No Content (Χωρίς περιεχόμενο)

Η αίτηση ήταν επιτυχής και δεν υπάρχει περιεχόμενο απάντησης για αποστολή. Οι κεφαλίδες μπορούν εξακολουθούν να μεταφέρουν χρήσιμη μεταδεδομένα, όπως ενημερωμένους επικυρωτές.

Λειτουργική καθοδήγηση: Μην συμπεριλάβετε σώμα απόκρισης.

205

Reset Content (Επαναφορά περιεχομένου)

Η αίτηση ήταν επιτυχής και ο πελάτης λαμβάνει εντολή να επαναφέρει την προβολή ή τη φόρμα που την υπέβαλε. Δεν αποστέλλεται περιεχόμενο απάντησης.

Λειτουργική καθοδήγηση: Χρήσιμο για αλληλεπιδράσεις που πρέπει να διαγράψουν/επαναφέρουν την τρέχουσα κατάσταση εισαγωγής.

206

Partial Content (Μερικό περιεχόμενο)

Ο διακομιστής εκπλήρωσε μια έγκυρη αίτηση εύρους (range request) και επιστρέφει μόνο το ζητούμενο εύρος ή εύρη byte. Το Content-Range περιγράφει τι παραδόθηκε.

Λειτουργική καθοδήγηση: Βεβαιωθείτε ότι οι τιμές range και Content-Range ταιριάζουν. κοινό για επαναλήψεις μέσων/λήψης.

207

Multi-Status (Πολλαπλή κατάσταση)

Μια απάντηση WebDAV αναφέρει ξεχωριστά αποτελέσματα για πολλαπλούς πόρους ή υπολειτουργίες, συνήθως σε δομημένο σώμα XML.

Λειτουργική καθοδήγηση: Ερμηνεύστε κάθε αποτέλεσμα ενσωματωμένου πόρου. η εξωτερική κατάσταση από μόνη της δεν είναι το πλήρες αποτέλεσμα.

208

Already Reported (Έχει ήδη αναφερθεί)

Μια απόκριση πολλαπλών καταστάσεων WebDAV παραλείπει μέλη που έχουν ήδη καταχωριστεί νωρίτερα στην ίδια απόκριση για την αποφυγή επανάληψης.

Λειτουργική καθοδήγηση: Ειδικά για WebDAV. ερμηνεύουν μαζί με την περιβάλλουσα απόκριση πολλαπλών καταστάσεων.

226

IM Used (Χρησιμοποιείται IM)

Ο διακομιστής εκπλήρωσε ένα GET χρησιμοποιώντας χειρισμούς παρουσίας και επιστρέφει μια αναπαράσταση που προέρχεται από τον τρέχοντα πόρο σύμφωνα με τον διαπραγματευμένο μηχανισμό delta.

Λειτουργική καθοδήγηση: Εξειδικευμένη κωδικοποίηση δέλτα. οι πελάτες και οι διακομιστές πρέπει να συμφωνήσουν για τον μετασχηματισμό.

3xx — Ανακατεύθυνση και επικύρωση προσωρινής μνήμης

300

Multiple Choices (Πολλαπλές επιλογές)

Ο στόχος έχει πολλαπλές αναπαραστάσεις ή προορισμούς και η απάντηση προσφέρει επιλογές. Ένας πελάτης ή χρήστης μπορεί να επιλέξει την προτιμώμενη παραλλαγή.

Λειτουργική καθοδήγηση: Συμπεριλάβετε σαφείς εναλλακτικές λύσεις. μην υποθέσετε ότι κάθε πελάτης θα επιλέξει αυτόματα.

301

Moved Permanently (Μετακινήθηκε μόνιμα)

Ο πόρος έχει μια διαρκή νέα URI. Οι πελάτες ενδέχεται να ενημερώσουν αποθηκευμένους συνδέσμους και προσωρινές μνήμες, οπότε χρησιμοποιήστε το μόνο όταν η μετακίνηση προορίζεται να διαρκέσει.

Λειτουργική καθοδήγηση: Για μετεγκαταστάσεις SEO, ανακατευθύνετε απευθείας στο τελικό ισοδύναμο URL και ενημερώστε τους εσωτερικούς συνδέσμους.

302

Found (Βρέθηκε)

Ο πόρος είναι προσωρινά διαθέσιμος σε άλλη URI. Η ιστορική συμπεριφορά επιτρέπει αλλαγές μεθόδου σε ορισμένες περιπτώσεις, επομένως δεν είναι η ασφαλέστερη επιλογή όταν ένα POST πρέπει να παραμείνει POST.

Λειτουργική καθοδήγηση: Χρήση για προσωρινές μετακινήσεις όταν είναι αποδεκτή η επανεγγραφή της μεθόδου. σκεφτείτε το 307 όταν δεν είναι.

303

See Other (Δείτε άλλα)

Ο πελάτης θα πρέπει να ανακτήσει τον πόρο που ονομάζεται από το Location με GET (ή HEAD όπως αρμόζει), αντί να επαναλάβει την αρχική ενέργεια. Χρησιμοποιείται συνήθως μετά την υποβολή φόρμας.

Λειτουργική καθοδήγηση: Υλοποιεί το μοτίβο Post/Redirect/Get και αποφεύγει την εκ νέου υποβολή της ενέργειας.

304

Not Modified (Δεν τροποποιήθηκε)

Ένα υπό όρους GET ή HEAD υποδεικνύει ότι η προσωρινά αποθηκευμένη αναπαράσταση είναι ακόμα τρέχουσα. Η απάντηση δεν έχει σώμα και επιτρέπει στον πελάτη να επαναχρησιμοποιήσει την αποθηκευμένη αντίγραφό του.

Λειτουργική καθοδήγηση: Επιστρέψτε μόνο όταν ταιριάζει ένα εργαλείο επικύρωσης όπως το If-None-Match ή το If-Modified-Since.

305

Use Proxy (Χρήση διαμεσολαβητή)

Μια ιστορική απάντηση πρότεινε στον πελάτη να έχει πρόσβαση στον πόρο μέσω διαμεσολαβητή (proxy). Είναι υπό κατάργηση για λόγους ασφαλείας και δεν πρέπει να χρησιμοποιείται από σύγχρονες υπηρεσίες.

Λειτουργική καθοδήγηση: Μην αναπτύξετε? Ρύθμιση παραμέτρων διακομιστή μεσολάβησης εκτός ζώνης.

306

Unused (Αχρησιμοποίητο)

Αυτή η τιμή είναι δεσμευμένη/αχρησιμοποίητη στις σύγχρονες προδιαγραφές HTTP. Δεν έχει τυπική λειτουργική σημασία για μια τρέχουσα διαδικτυακή εφαρμογή.

Λειτουργική καθοδήγηση: Μην το στείλετε.

307

Temporary Redirect (Προσωρινή ανακατεύθυνση)

Ο πόρος βρίσκεται προσωρινά σε άλλη URI και ο πελάτης πρέπει να διατηρήσει την αρχική μέθοδο και το σώμα όταν ακολουθεί την ανακατεύθυνση.

Λειτουργική καθοδήγηση: Χρησιμοποιείται όταν η προσωρινή μετεγκατάσταση δεν πρέπει να μετατρέπει το POST σε GET.

308

Permanent Redirect (Μόνιμη ανακατεύθυνση)

Ο πόρος έχει μετακινηθεί μόνιμα και ο πελάτης πρέπει να διατηρήσει την αρχική μέθοδο και το σώμα όταν ακολουθεί την ανακατεύθυνση.

Λειτουργική καθοδήγηση: Χρήση για μόνιμες κινήσεις όπου έχει σημασία η διατήρηση της μεθόδου. ενημέρωση κανονικών/εσωτερικών παραπομπών.

4xx — Σφάλματα πελάτη/αίτησης

400

Bad Request (Εσφαλμένη αίτηση)

Ο διακομιστής δεν μπορεί να επεξεργαστεί την αίτηση επειδή η σύνταξη, το πλαίσιο (framing) ή τα παρεχόμενα δεδομένα δεν είναι έγκυρα. Η αμετάκλητη επανάληψη της ίδιας αίτησης είναι απίθανο να βοηθήσει.

Λειτουργική καθοδήγηση: Επιθεωρήστε την κωδικοποίηση URL, τη σύνταξη JSON/σώμα, τα απαιτούμενα πεδία και ζητήστε το πλαίσιο.

401

Unauthorized (Μη εξουσιοδοτημένο)

Στην αίτηση λείπουν έγκυρα διαπιστευτήρια ελέγχου ταυτότητας για τον στόχο. Παρά το όνομά της, αυτή η απάντηση σημαίνει ότι απαιτείται έλεγχος ταυτότητας ή απέτυχε.

Λειτουργική καθοδήγηση: Στείλτε τα αναμενόμενα διαπιστευτήρια και συμπεριλάβετε μια πρόκληση WWW-Authenticate.

402

Payment Required (Απαιτείται πληρωμή)

Δεσμευμένο για μελλοντική χρήση, αν και ορισμένα προϊόντα το χρησιμοποιούν για ροές εργασιών πληρωμής ή ορίων (quota). Δεν υπάρχει ενιαία, καθολικά διαλειτουργική συμπεριφορά πληρωμής.

Λειτουργική καθοδήγηση: Αντιμετωπίστε τις συγκεκριμένες έννοιες του προμηθευτή ως τέτοιες. τεκμηριώστε τη σύμβαση API.

403

Forbidden (Απαγορεύεται)

Ο διακομιστής κατανόησε την αίτηση αλλά αρνείται να την εκπληρώσει. Τα έγκυρα διαπιστευτήρια δεν αλλάζουν απαραίτητα το αποτέλεσμα επειδή ο περιορισμός μπορεί να βασίζεται σε πολιτική.

Λειτουργική καθοδήγηση: Ελέγξτε τα δικαιώματα, την πολιτική πρόσβασης, τους κανόνες IP/WAF και την εξουσιοδότηση σε επίπεδο πόρων.

404

Not Found (Δεν βρέθηκε)

Ο διακομιστής δεν μπορεί να βρει τρέχουσα αναπαράσταση για την αιτούμενη URI ή δεν είναι πρόθυμος να αποκαλύψει ότι υπάρχει. Η απάντηση από μόνη της δεν λέει εάν η απουσία είναι προσωρινή ή μόνιμη.

Λειτουργική καθοδήγηση: Επισκευάστε το URL, επαναφέρετε τον πόρο ή χρησιμοποιήστε το 410 όταν είναι γνωστό ότι η αφαίρεση είναι μόνιμη.

405

Method Not Allowed (Η μέθοδος δεν επιτρέπεται)

Ο πόρος υπάρχει, αλλά δεν υποστηρίζει τη μέθοδο που χρησιμοποιείται σε αυτήν την αίτηση.

Λειτουργική καθοδήγηση: Επιστρέψτε μια μέθοδο καταχώρισης κεφαλίδας Allow που αποδέχεται ο πόρος.

406

Not Acceptable (Μη αποδεκτό)

Ο διακομιστής δεν μπορεί να παράγει αναπαράσταση που να ταιριάζει με τις προληπτικές προτιμήσεις αποδοχής (accept preferences) του πελάτη.

Λειτουργική καθοδήγηση: Χαλαρώστε τους περιορισμούς του Accept ή ρυθμίστε κατάλληλη πολιτική αναπαράστασης και διαπραγμάτευσης.

407

Proxy Authentication Required (Απαιτείται έλεγχος ταυτότητας διαμεσολαβητή)

Ένας ενδιάμεσος διαμεσολαβητής (proxy) απαιτεί διαπιστευτήρια προτού προωθήσει την αίτηση.

Λειτουργική καθοδήγηση: Έλεγχος ταυτότητας στο διακομιστή μεσολάβησης χρησιμοποιώντας Proxy-Authenticate / Proxy-Authorization. αυτό διαφέρει από τον έλεγχο ταυτότητας προέλευσης.

408

Request Timeout (Λήξη χρονικού ορίου αίτησης)

Ο διακομιστής δεν έλαβε την πλήρη αίτηση εντός του χρόνου που ήταν προετοιμασμένος να περιμένει. Ο πελάτης μπορεί να δοκιμάσει ξανά σε νέα σύνδεση.

Λειτουργική καθοδήγηση: Ελέγξτε τις ρυθμίσεις διακοπής δικτύου, το μέγεθος μεταφόρτωσης και τις ρυθμίσεις χρονικού ορίου λήξης διακομιστή/διακομιστή μεσολάβησης.

409

Conflict (Σύγκρουση)

Η αίτηση έρχεται σε σύγκρουση με την τρέχουσα κατάσταση του πόρου, όπως μια σύγκρουση έκδοσης ή μια προσπάθεια δημιουργίας αντιγράφου.

Λειτουργική καθοδήγηση: Εξηγήστε τη διένεξη και παρέχετε αρκετή τρέχουσα κατάσταση για να την επιλύσει ο πελάτης.

410

Gone (Δεν διατίθεται πλέον)

Ο πόρος είναι εσκεμμένα και πιθανώς μόνιμα μη διαθέσιμος, χωρίς γνωστή αντικατάσταση. Αυτό είναι ισχυρότερο από μια γενική απάντηση Not Found.

Λειτουργική καθοδήγηση: Χρήση όταν η αφαίρεση είναι σκόπιμη. αφαιρέστε απαρχαιωμένους εσωτερικούς συνδέσμους και αναφορές.

411

Length Required (Απαιτείται μήκος)

Ο διακομιστής απαιτεί μια κεφαλίδα Content-Length αλλά η αίτηση δεν παρείχε καμία.

Λειτουργική καθοδήγηση: Στείλτε ένα ακριβές Content-Length ή χρησιμοποιήστε ένα υποστηριζόμενο πλαίσιο μεταφοράς.

412

Precondition Failed (Η προϋπόθεση απέτυχε)

Μια συνθήκη αίτησης όπως το If-Match αξιολογήθηκε ως ψευδής, οπότε ο διακομιστής δεν εκτέλεσε την αιτούμενη ενέργεια.

Λειτουργική καθοδήγηση: Ανανεώστε την αναπαράσταση και δοκιμάστε ξανά με τους τρέχοντες επικυρωτές/κατάσταση.

413

Content Too Large (Πολύ μεγάλο περιεχόμενο)

Το σώμα της αίτησης υπερβαίνει ένα όριο που ο διακομιστής είναι πρόθυμος ή ικανός να επεξεργαστεί. Ο διακομιστής ενδέχεται να κλείσει τη σύνδεση ή να επιτρέψει επανάληψη μετά τη μείωση του σώματος.

Λειτουργική καθοδήγηση: Μειώστε το μέγεθος του φορτίου ή προσαρμόστε τα τεκμηριωμένα όρια μεταφόρτωσης.

414

URI Too Long (Πολύ μεγάλη URI)

Ο στόχος της αίτησης είναι μεγαλύτερος από ό,τι ο διακομιστής είναι πρόθυμος να ερμηνεύσει, συχνά λόγω υπερβολικά μεγάλου συμβολοσειράς ερωτήματος (query string).

Λειτουργική καθοδήγηση: Χρησιμοποιήστε ένα μικρότερο URI ή μετακινήστε κατάλληλα δεδομένα σε ένα σώμα αιτήματος.

415

Unsupported Media Type (Μη υποστηριζόμενος τύπος πολυμέσων)

Ο διακομιστής αρνείται το σώμα της αίτησης επειδή ο τύπος πολυμέσων, η κωδικοποίηση περιεχομένου ή η επιθεωρημένη μορφή δεν υποστηρίζονται.

Λειτουργική καθοδήγηση: Στείλτε μια υποστηριζόμενη κωδικοποίηση Content-Type και ένα σώμα που να ταιριάζει.

416

Range Not Satisfiable (Το εύρος δεν είναι ικανοποιητικό)

Το ζητούμενο εύρος byte δεν μπορεί να εξυπηρετηθεί, για παράδειγμα επειδή ξεκινά πέρα από το μήκος αναπαράστασης.

Λειτουργική καθοδήγηση: Ελέγξτε ξανά το μήκος πόρων και τις μονάδες range. Οι διακομιστές ενδέχεται να επιστρέψουν Content-Range: byte */μήκος.

417

Expectation Failed (Η προσδοκία απέτυχε)

Ο διακομιστής ή ο ενδιάμεσος δεν μπορεί να ικανοποιήσει μια προσδοκία που δηλώνεται στην κεφαλίδα expect.

Λειτουργική καθοδήγηση: Δοκιμάστε ξανά χωρίς τη μη υποστηριζόμενη προσδοκία όταν είναι ασφαλές και κατάλληλο.

418

I'm a teapot (Είμαι τσαγιέρα)

Μια χιουμοριστική κατάσταση που προέρχεται από προδιαγραφή της Πρωταπριλίας. Δεν αποτελεί κανονικό συμβόλαιο σφάλματος εφαρμογής, αν και ορισμένες υπηρεσίες το χρησιμοποιούν παιχνιδιάρικα.

Λειτουργική καθοδήγηση: Μην εξαρτάστε από αυτό για διαλειτουργική συμπεριφορά παραγωγής.

421

Misdirected Request (Εσφαλμένα κατευθυνόμενη αίτηση)

Η αίτηση έφτασε σε διακομιστή που δεν μπορεί να παράγει αυθεντική απάντηση για την URI στόχο, συχνά επειδή η δρομολόγηση σύνδεσης ή η αρχή HTTP δεν ταιριάζουν.

Λειτουργική καθοδήγηση: Δοκιμάστε ξανά ένα κατάλληλο connection και επιθεωρήστε Host/:authority, SNI και δρομολόγηση διακομιστή μεσολάβησης.

422

Unprocessable Content (Μη επεξεργάσιμο περιεχόμενο)

Ο τύπος περιεχομένου και η σύνταξη είναι κατανοητά, αλλά ο διακομιστής δεν μπορεί να εφαρμόσει τις οδηγίες ή να επικυρώσει το υποβληθέν περιεχόμενο.

Λειτουργική καθοδήγηση: Επιστροφή λεπτομερειών επικύρωσης σε επίπεδο πεδίου με δυνατότητα ενεργοποίησης. Η διόρθωση του ωφέλιμου φορτίου μπορεί να πετύχει το allow.

423

Locked (Κλειδωμένο)

Ένας πόρος WebDAV είναι κλειδωμένος, επομένως η αιτούμενη μέθοδος δεν μπορεί να εκτελεστεί μέχρι να επιλυθεί η συνθήκη κλειδώματος.

Λειτουργική καθοδήγηση: Ελέγξτε την ιδιοκτησία κλειδώματος, το χρονικό όριο λήξης και το χειρισμό κλειδώματος WebDAV.

424

Failed Dependency (Αποτυχημένη εξάρτηση)

Μια λειτουργία WebDAV απέτυχε επειδή μια απαιτούμενη προηγούμενη λειτουργία στην ίδια ακολουθία αιτήσεων απέτυχε.

Λειτουργική καθοδήγηση: Επιλύστε την προηγούμενη αποτυχημένη ενέργεια πριν δοκιμάσετε ξανά τις εξαρτημένες λειτουργίες.

425

Too Early (Πολύ νωρίς)

Ο διακομιστής αρνείται να επεξεργαστεί μια αίτηση που ενδέχεται να έχει αναπαραχθεί (replayed) κατά τα πρώιμα δεδομένα, για τη μείωση του κινδύνου επανάληψης.

Λειτουργική καθοδήγηση: Δοκιμάστε ξανά μετά τη δημιουργία του connection χωρίς πρώιμα δεδομένα.

426

Upgrade Required (Απαιτείται αναβάθμιση)

Ο διακομιστής αρνείται το τρέχον πρωτόκολλο και υποδεικνύει ότι ο πελάτης πρέπει να μεταβεί σε άλλο.

Λειτουργική καθοδήγηση: Συμπεριλάβετε μια κεφαλίδα Upgrade που περιγράφει υποστηριζόμενες επιλογές πρωτοκόλλου.

428

Precondition Required (Απαιτείται προϋπόθεση)

Ο διακομιστής απαιτεί μια υπό όρους αίτηση για την αποτροπή χαμένων ενημερώσεων, αλλά ο πελάτης έστειλε μια ανεξάρτητη (unconditional).

Λειτουργική καθοδήγηση: Λάβετε την τρέχουσα κατάσταση και υποβάλετε μια κατάλληλη συνθήκη όπως If-Match.

429

Too Many Requests (Πάρα πολλές αιτήσεις)

Ο πελάτης έχει στείλει πάρα πολλές αιτήσεις σε δεδομένη περίοδο, βάσει ορίου ρυθμού που ορίζεται από τον διακομιστή.

Λειτουργική καθοδήγηση: Υποχωρήστε, τιμήστε το Retry-After όταν υπάρχει και αποφύγετε τις συγχρονισμένες εκρήξεις επανάληψης.

431

Request Header Fields Too Large (Πολύ μεγάλα πεδία κεφαλίδας αίτησης)

Ο διακομιστής δεν θα επεξεργαστεί την αίτηση επειδή ένα ή περισσότερα πεδία κεφαλίδας, ή το συνδυασμένο σύνολο κεφαλίδων, είναι πάρα πολύ μεγάλα.

Λειτουργική καθοδήγηση: Μειώστε τα cookies ή τις προσαρμοσμένες κεφαλίδες ή προσαρμόστε ένα σκόπιμο όριο διακομιστή.

451

Unavailable For Legal Reasons (Μη διαθέσιμο για νομικούς λόγους)

Ο διακομιστής δεν μπορεί να παράσχει τον αιτούμενο πόρο λόγω νομικού περιορισμού.

Λειτουργική καθοδήγηση: Όπου ενδείκνυται, εξηγήστε τον περιορισμό και το πεδίο εφαρμογής του χωρίς να εκθέσετε προστατευμένες πληροφορίες.

5xx — Σφάλματα διακομιστή και ενδιάμεσων

500

Internal Server Error (Εσωτερικό σφάλμα διακομιστή)

Ο διακομιστής αντιμετώπισε μια απροσδόκητη κατάσταση και δεν μπορεί να ολοκληρώσει την αίτηση. Είναι μια γενική εναλλακτική λύση όταν δεν ισχύει κάποιο πιο ακριβές σφάλμα διακομιστή.

Λειτουργική καθοδήγηση: Συσχετίστε το αίτημα με αρχεία καταγραφής διακομιστή και αποφύγετε την έκθεση των ιχνών στοίβας στους επισκέπτες.

501

Not Implemented (Δεν έχει υλοποιηθεί)

Ο διακομιστής δεν υποστηρίζει τη λειτουργικότητα που απαιτείται για την εκπλήρωση της αίτησης, συνήθως μια μη υλοποιημένη μέθοδος ή δυνατότητα.

Λειτουργική καθοδήγηση: Εφαρμόστε τη δυνατότητα ή χρησιμοποιήστε μια υποστηριζόμενη μέθοδο. δεν προορίζεται για προσωρινή υπερφόρτωση.

502

Bad Gateway (Κακή πύλη δικτύου)

Ένας διακομιστής που λειτουργεί ως πύλη (gateway) ή διαμεσολαβητής έλαβε μη έγκυρη απάντηση από έναν ανάντη διακομιστή (upstream server).

Λειτουργική καθοδήγηση: Επιθεωρήστε την κατάσταση ανοδικής ροής, τις ρυθμίσεις πρωτοκόλλου/TLS, DNS και αρχεία καταγραφής διακομιστή μεσολάβησης.

503

Service Unavailable (Η υπηρεσία δεν είναι διαθέσιμη)

Ο διακομιστής είναι προσωρινά ανήμπορος να χειριστεί την αίτηση, συχνά λόγω συντήρησης ή υπερφόρτωσης.

Λειτουργική καθοδήγηση: Εάν είναι δυνατόν, παρέχετε Retry-After, μια χρήσιμη απόκριση και στοιχεία ελέγχου προσωρινής μνήμης κατάλληλα για μια προσωρινή αποτυχία.

504

Gateway Timeout (Λήξη χρονικού ορίου πύλης δικτύου)

Μια πύλη δικτύου (gateway) ή διαμεσολαβητής δεν έλαβε έγκαιρη απάντηση από μια ανάντη υπηρεσία.

Λειτουργική καθοδήγηση: Διερευνήστε τον λανθάνοντα χρόνο ανάντη, τις διαδρομές δικτύου και τους προϋπολογισμούς χρονικού ορίου σε όλη την αλυσίδα.

505

HTTP Version Not Supported (Η έκδοση HTTP δεν υποστηρίζεται)

Ο διακομιστής δεν υποστηρίζει την κύρια έκδοση HTTP που χρησιμοποιείται στην αίτηση.

Λειτουργική καθοδήγηση: Χρησιμοποιήστε μια υποστηριζόμενη έκδοση πρωτοκόλλου ή ενημερώστε τη διαμόρφωση διακομιστή/διακομιστή μεσολάβησης.

506

Variant Also Negotiates (Η παραλλαγή διαπραγματεύεται επίσης)

Ένα σφάλμα διαμόρφωσης διακομιστή δημιούργησε μια κυκλική ρύθμιση διαπραγμάτευσης περιεχομένου στην οποία η επιλεγμένη παραλλαγή διαπραγματεύεται ξανά.

Λειτουργική καθοδήγηση: Διορθώστε τη διαμόρφωση παραλλαγής/διαπραγμάτευσης. αυτό είναι σφάλμα από την πλευρά της προέλευσης.

507

Insufficient Storage (Ανεπαρκής αποθηκευτικός χώρος)

Ένας διακομιστής WebDAV δεν μπορεί να αποθηκεύσει την αναπαράσταση που απαιτείται για την ολοκλήρωση της λειτουργίας.

Λειτουργική καθοδήγηση: Δωρεάν ή παροχή αποθηκευτικού χώρου και ελέγξτε τα όρια πριν προσπαθήσετε ξανά.

508

Loop Detected (Εντοπίστηκε βρόχος)

Ένας διακομιστής εντόπισε άπειρο βρόχο κατά την επεξεργασία μιας αίτησης, συνήθως κατά τη διέλευση δεσμών WebDAV.

Λειτουργική καθοδήγηση: Σπάστε την κυκλική σχέση πόρων ή τον κανόνα επεξεργασίας.

510

Not Extended (Δεν επεκτάθηκε)

Η αίτηση απαιτεί μια επέκταση που ο διακομιστής δεν υποστηρίζει.

Λειτουργική καθοδήγηση: Χρησιμοποιήστε ένα υποστηριζόμενο σύνολο επεκτάσεων ή διαπραγματευτείτε μια εναλλακτική.

511

Network Authentication Required (Απαιτείται έλεγχος ταυτότητας δικτύου)

Ο πελάτης πρέπει να πιστοποιηθεί για να αποκτήσει πρόσβαση στο δικτύο, συνήθως σε ένα captive portal. Προορίζεται για ενδιάμεσους δικτύου, όχι για σύνδεση σε ιστότοπο προέλευσης.

Λειτουργική καθοδήγηση: Ολοκληρώστε τον έλεγχο ταυτότητας πρόσβασης δικτύου και, στη συνέχεια, δοκιμάστε ξανά το αρχικό αίτημα.

Αξιοσημείωτες μη τυπικές και συγκεκριμένες απαντήσεις για τον πάροχο

Αυτές οι τιμές εμφανίζονται σε συγκεκριμένα προϊόντα, αρχεία καταγραφής διακομιστή, CDN ή εφαρμογές. Δεν είναι εναλλάξιμα με καταχωρημένες τυπικές έννοιες. συμβουλευτείτε τη σύμβαση της υπηρεσίας παραγωγής.

419

Authentication Timeout (non-standard) (Λήξη χρονικού ορίου ελέγχου ταυτότητας — μη τυπικό)

Ορισμένες εφαρμογές χρησιμοποιούν αυτήν την ετικέτα όταν λήγει μια συνεδρία ελέγχου ταυτότητας. Δεν είναι καθολικά εκχωρημένη κατάσταση HTTP, επομένως οι πελάτες δεν μπορούν να βασίζονται σε συνεπή σημασιολογία.

Λειτουργική καθοδήγηση: Ανανεώστε τον έλεγχο ταυτότητας σύμφωνα με τη σύμβαση παροχής υπηρεσιών.

420

Enhance Your Calm (non-standard) (Βελτιώστε την ηρεμία σας — μη τυπικό)

Μια απόκριση ειδική για κατασκευαστή που χρησιμοποιούνταν ιστορικά για throttling. Η σημασία της ορίζεται από την υλοποίηση.

Λειτουργική καθοδήγηση: Ακολουθήστε τις τεκμηριωμένες οδηγίες για τα όρια ρυθμού αιτημάτων.

444

Connection Closed (non-standard) (Η σύνδεση έκλεισε — μη τυπικό)

Ορισμένοι διακομιστές κλείνουν τη σύνδεση χωρίς να στείλουν συμβατική απάντηση, συχνά ως μέτρο φιλτραρίσματος.

Λειτουργική καθοδήγηση: Ελέγξτε τα αρχεία καταγραφής παρόχων. Οι πελάτες ενδέχεται να αναφέρουν ένα σφάλμα δικτύου αντί να εμφανίζουν αυτόν τον κωδικό.

449

Retry With (non-standard) (Επανάληψη με — μη τυπικό)

Μια επέκταση της Microsoft που χρησιμοποιείται από ορισμένες υπηρεσίες για να ζητήσει από έναν πελάτη να δοκιμάσει ξανά με πρόσθετες πληροφορίες.

Λειτουργική καθοδήγηση: Ακολουθήστε την τεκμηρίωση του συγκεκριμένου API.

499

Client Closed Request (non-standard) (Ο πελάτης έκλεισε την αίτηση — μη τυπικό)

Ένας αντίστροφος διαμεσολαβητής (reverse proxy) μπορεί να το καταγράψει όταν ο πελάτης αποσυνδέεται πριν ολοκληρωθεί η ανάντη απάντηση. Συνήθως πρόκειται για ταξινόμηση αρχείου καταγραφής παρά για απάντηση που παραδίδεται σε αυτόν τον πελάτη.

Λειτουργική καθοδήγηση: Διερευνήστε ακυρώσεις πελατών και επιβραδύνετε τα αιτήματα ανάντη.

509

Bandwidth Limit Exceeded (non-standard) (Υπέρβαση ορίου εύρους ζώνης — μη τυπικό)

Ορισμένες πλατφόρμες φιλοξενίας χρησιμοποιούν αυτόν τον κωδικό για όριο ποσόστωσης ή εύρους ζώνης. Δεν είναι γενική διαλειτουργική σημασία HTTP.

Λειτουργική καθοδήγηση: Ελέγξτε το όριο και τη διαμόρφωση χρέωσης του host.

520

Web Server Returned an Unknown Error (vendor-specific) (Ο διακομιστής ιστού επέστρεψε άγνωστο σφάλμα — ειδικό για κατασκευαστή)

Ένα CDN ή διαμεσολαβητής μπορεί να το χρησιμοποιήσει όταν λαμβάνει μια απροσδόκητη ή κενή απάντηση προέλευσης.

Λειτουργική καθοδήγηση: Συγκρίνετε το edge και τα αρχεία καταγραφής προέλευσης. βεβαιωθείτε ότι η προέλευση εκπέμπει μια έγκυρη απόκριση HTTP.

521

Web Server Is Down (vendor-specific) (Ο διακομιστής ιστού είναι εκτός λειτουργίας — ειδικό για κατασκευαστή)

Ένας διαμεσολαβητής δεν μπόρεσε να δημιουργήσει σύνδεση με την προέλευση ή η προέλευση την αρνήθηκε.

Λειτουργική καθοδήγηση: Ελέγξτε τη διαθεσιμότητα προέλευσης, τους κανόνες του τείχους προστασίας και τις λίστες επιτρεπόμενων διακομιστή μεσολάβησης.

522

Connection Timed Out (vendor-specific) (Λήξη χρονικού ορίου σύνδεσης — ειδικό για κατασκευαστή)

Μια υπηρεσία edge συνδέθηκε ή επιχείρησε να συνδεθεί στην προέλευση αλλά δεν ολοκλήρωσε την ανταλλαγή εντός του χρονικού ορίου της.

Λειτουργική καθοδήγηση: Ελέγξτε την ανταπόκριση προέλευσης και τον λανθάνοντα χρόνο δικτύου.

523

Origin Is Unreachable (vendor-specific) (Ο διακομιστής προέλευσης δεν είναι προσβάσιμος — ειδικό για κατασκευαστή)

Ένας διαμεσολαβητής δεν μπόρεσε να φτάσει στη διαμορφωμένη διεύθυνση προέλευσης.

Λειτουργική καθοδήγηση: Ελέγξτε την ανάλυση, τη δρομολόγηση και τη διαμόρφωση IP προέλευσης DNS.

524

A Timeout Occurred (vendor-specific) (Παρουσιάστηκε λήξη χρονικού ορίου — ειδικό για κατασκευαστή)

Η σύνδεση με την προέλευση ήταν επιτυχής, αλλά η προέλευση δεν έστειλε έγκαιρη απάντηση HTTP.

Λειτουργική καθοδήγηση: Μειώστε τον χρόνο επεξεργασίας του διακομιστή προέλευσης ή προσαρμόστε τις υποστηριζόμενες ρυθμίσεις χρονικού ορίου.

525

SSL Handshake Failed (vendor-specific) (Η χειραψία SSL απέτυχε — ειδικό για κατασκευαστή)

Ένας διαμεσολαβητής δεν μπόρεσε να ολοκληρώσει τη διαπραγμάτευση TLS με την προέλευση.

Λειτουργική καθοδήγηση: Επικύρωση πιστοποιητικών, συμβατότητας πρωτοκόλλου/κρυπτογράφησης και SNI.

526

Invalid SSL Certificate (vendor-specific) (Μη έγκυρο πιστοποιητικό SSL — ειδικό για κατασκευαστή)

Ένας ενδιάμεσος απέρριψε το πιστοποιητικό προέλευσης κατά την επικύρωση.

Λειτουργική καθοδήγηση: Εγκαταστήστε ένα έγκυρο, σωστά ονομασμένο, αξιόπιστο, μη λήξει πιστοποιητικό και πλήρη αλυσίδα.

527

Railgun Error (vendor-specific) (Σφάλμα Railgun — ειδικό για κατασκευαστή)

Μια παλαιότερη/ειδική για κατασκευαστή κατάσταση διαμεσολαβητή αναφέρει αποτυχία σε σύνδεση επιτάχυνσης προέλευσης.

Λειτουργική καθοδήγηση: Επιθεωρήστε τη σύνδεση σύνδεσης και τη διαδρομή προέλευσης για συγκεκριμένο πάροχο.

598

Network Read Timeout (non-standard) (Λήξη χρονικού ορίου ανάγνωσης δικτύου — μη τυπικό)

Ορισμένοι πελάτες ή διαμεσολαβητές χρησιμοποιούν αυτήν την τιμή για να περιγράψουν λήξη χρονικού ορίου ανάγνωσης δικτύου. Δεν έχει καθολική σημασία HTTP.

Λειτουργική καθοδήγηση: Εξετάστε τα διαγνωστικά στοιχεία του client ή του proxy.

599

Network Connect Timeout (non-standard) (Λήξη χρονικού ορίου σύνδεσης δικτύου — μη τυπικό)

Ορισμένοι διαμεσολαβητές χρησιμοποιούν αυτήν την τιμή όταν λήγει ο χρόνος προσπάθειας σύνδεσης δικτύου. Η σημασία της εξαρτάται από την υλοποίηση.

Λειτουργική καθοδήγηση: Ελέγξτε την προσβασιμότητα και τις ρυθμίσεις χρονικού ορίου.

Χρήση κωδικών κατάστασης σε ελέγχους ανακατεύθυνσης και SEO

Για μια μόνιμη μετακίνηση URL, χρησιμοποιήστε μια μόνιμη ανακατεύθυνση μόνο όταν ο προορισμός προορίζεται να αντικαταστήσει το παλιό URL. για μια προσωρινή αλλαγή, επιλέξτε μια προσωρινή απόκριση. Κρατήστε τις αλυσίδες κοντές και δείξτε τον τελικό ισοδύναμο προορισμό. Επιβεβαιώστε ότι κάθε τιμή Location επιλύεται, ότι η τελική απόκριση είναι κατάλληλη και ότι οι κανονικές ετικέτες και οι εσωτερικοί σύνδεσμοι συμφωνούν με το προβλεπόμενο URL. Ένα 2xx στο τέλος επιβεβαιώνει μια απόκριση επιτυχίας HTTP, όχι ότι η σελίδα είναι χρήσιμη, ευρετηριάσσιμη ή τεχνικά υγιής.

Πηγές και σημειώσεις αναφοράς

Αυτή η σελίδα συνοψίζει την πρακτική σημασία των κωδικών κατάστασης HTTP. Το μητρώο προτύπων και τα RFC αποτελούν τις έγκυρες πηγές για τους τυποποιημένους κωδικούς· το MDN παρέχει έναν προσιτό τεχνικό οδηγό, ενώ η Wikipedia είναι μια συμπληρωματική επισκόπηση που συντηρείται από την κοινότητα.