Μια εύχρηστη αναφορά για κάθε μέθοδο αιτήματος HTTP — GET, POST, PUT, PATCH, DELETE και τις υπόλοιπες, καθώς και WebDAV — που δείχνει με μια ματιά αν καθεμία είναι ασφαλής, ταυτοδύναμη (idempotent) και cacheable, αν δέχεται σώμα, και ένα τυπικό παράδειγμα. Στον περιηγητή σας, δωρεάν.

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

Μέθοδος Σκοπός Ασφαλής Ταυτοδύναμη Αποθηκεύσιμη στην cache Σώμα Τυπική χρήση
Καμία μέθοδος δεν ταιριάζει με την αναζήτησή σας.
Δοκιμάστε διαφορετικό όνομα ή όρο — για παράδειγμα PATCH, idempotent ή cache.
Ναι Όχι Υπό συνθήκη Προαιρετικό Αποθαρρύνεται

Σχετικά με το Μέθοδοι HTTP

Αυτή η αναφορά μεθόδων HTTP βάζει κάθε τυπική μέθοδο αιτήματος — GET, HEAD, POST, PUT, PATCH, DELETE, CONNECT, OPTIONS και TRACE — συν τις κοινές επεκτάσεις WebDAV σε έναν εξετάσιμο πίνακα. Για κάθε μέθοδο απαντά στις ερωτήσεις που πραγματικά σκέφτονται οι προγραμματιστές: είναι ασφαλής, είναι idempotent, είναι cacheable, μεταφέρει σώμα αιτήματος και πώς μοιάζει μια τυπική χρήση.

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

Η αναζήτηση ταιριάζει με ονόματα μεθόδων, ιδιότητες και περιπτώσεις χρήσης — PATCH, idempotent και cache φιλτράρουν όλα τον πίνακα — και ένας διακόπτης ομάδας ξεχωρίζει τις τυπικές μεθόδους από το σετ WebDAV. Κάθε όνομα μεθόδου αντιγράφεται στο πρόχειρο με ένα κλικ.

Πώς να χρησιμοποιήσετε το Μέθοδοι HTTP

  1. Εξετάστε τον πίνακα για να συγκρίνετε μεθόδους στις στήλες Safe, Idempotent, Cacheable και Body.
  2. Αναζητήστε με όνομα, ιδιότητα ή περίπτωση χρήσης — για παράδειγμα PUT, idempotent ή upload.
  3. Εναλλάξτε ανάμεσα στις ομάδες Standard και WebDAV για να συμπεριλάβετε ή να εξαιρέσετε τις μεθόδους επέκτασης.
  4. Περάστε το ποντίκι πάνω από τα tooltip των στηλών για έναν απλό ορισμό κάθε ιδιότητας.
  5. Κάντε κλικ στο κουμπί αντιγραφής για να πάρετε ένα όνομα μεθόδου για την προδιαγραφή API ή το τεστ σας.

Συχνές ερωτήσεις

Ασφαλής σημαίνει ότι το αίτημα δεν αλλάζει καθόλου την κατάσταση του διακομιστή — τα GET και HEAD είναι μόνο για ανάγνωση. Idempotent σημαίνει ότι η επανάληψη του ίδιου αιτήματος έχει το ίδιο αποτέλεσμα με την αποστολή του μία φορά — το DELETE είναι idempotent αλλά όχι ασφαλές, επειδή η πρώτη κλήση αλλάζει πράγματι την κατάσταση.

Το PUT αντικαθιστά ολόκληρο τον πόρο με το σώμα που στέλνετε και είναι idempotent. Το PATCH εφαρμόζει μια μερική τροποποίηση — αλλάζουν μόνο τα πεδία που συμπεριλαμβάνετε — και δεν είναι εγγυημένα idempotent. Χρησιμοποιήστε το PUT για πλήρεις αντικαταστάσεις και το PATCH για στοχευμένες ενημερώσεις.

Επειδή πελάτες, proxy και SDK επαναλαμβάνουν αυτόματα idempotent αιτήματα μετά από timeouts ή διακοπείσες συνδέσεις. Ένα μη-idempotent POST που επαναλαμβάνεται τυφλά μπορεί να δημιουργήσει διπλές παραγγελίες ή εγγραφές, γι' αυτό τα API πληρωμών συνδυάζουν το POST με κλειδιά idempotency.

Οι αποκρίσεις GET και HEAD είναι προεπιλεγμένα cacheable. Οι αποκρίσεις POST μπορούν να αποθηκευτούν σε cache μόνο όταν ρητές κεφαλίδες φρεσκάδας το επιτρέπουν, κάτι σπάνιο στην πράξη. Οι υπόλοιπες μέθοδοι δεν είναι cacheable — οι αποκρίσεις τους δεν πρέπει να αποθηκεύονται και να επαναχρησιμοποιούνται.

Το WebDAV επεκτείνει το HTTP για απομακρυσμένη διαχείριση αρχείων, προσθέτοντας μεθόδους όπως PROPFIND, MKCOL, COPY, MOVE, LOCK και UNLOCK. Θα τις συναντήσετε όταν εργάζεστε με διακομιστές WebDAV, πρωτόκολλα ημερολογίου/επαφών χτισμένα πάνω τους, ή ενσωματώσεις δικτυακού δίσκου.

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

Κοινοποίηση
Χρειάζεστε βοήθεια;
Βρήκατε πρόβλημα με αυτό το εργαλείο; Ενημερώστε μας.
Αναφορά προβλήματος

Προσθέστε αυτό το δωρεάν εργαλείο στον δικό σας ιστότοπο — αντιγράψτε και επικολλήστε τον παρακάτω κώδικα.