แหล่งอ้างอิงที่อ่านง่ายสำหรับทุกเมธอดคำขอ HTTP — GET, POST, PUT, PATCH, DELETE และอื่น ๆ พร้อม WebDAV — แสดงในที่เดียวว่าแต่ละตัวปลอดภัย idempotent และแคชได้หรือไม่ รับเนื้อหาหรือไม่ พร้อมตัวอย่างทั่วไป ในเบราว์เซอร์ ฟรี

ทุกเมธอดคำขอ HTTP มาตรฐานและความหมายของมัน เคียงข้างกัน ทุกอย่างทำงานในเบราว์เซอร์ของคุณจากแหล่งอ้างอิงในตัว — ไม่มีการส่งข้อมูลไปยังเซิร์ฟเวอร์

เมธอด วัตถุประสงค์ ปลอดภัย Idempotent แคชได้ เนื้อหา การใช้งานทั่วไป
ไม่มีเมธอดที่ตรงกับการค้นหาของคุณ
ลองชื่อหรือคำอื่น — เช่น PATCH, idempotent หรือ cache
ใช่ ไม่ มีเงื่อนไข ไม่บังคับ ไม่แนะนำ

เกี่ยวกับ เมธอด HTTP

ตัวอ้างอิงเมธอด HTTP นี้รวบรวมเมธอดคำขอมาตรฐานทุกตัว ได้แก่ GET, HEAD, POST, PUT, PATCH, DELETE, CONNECT, OPTIONS และ TRACE รวมถึงส่วนขยาย WebDAV ที่พบบ่อยไว้ในตารางเดียวที่อ่านง่าย สำหรับแต่ละเมธอด ตารางนี้ตอบคำถามที่นักพัฒนามักคิดจริง ๆ คือ ปลอดภัย (safe) หรือไม่ เป็น idempotent หรือไม่ แคชได้หรือไม่ มี request body หรือไม่ และตัวอย่างการใช้งานทั่วไปเป็นอย่างไร

คุณสมบัติเชิงความหมายสามข้อนี้ผลักดันการตัดสินใจออกแบบจริง เมธอดที่ปลอดภัยเป็นแบบอ่านอย่างเดียวและสามารถ prefetch ได้อย่างอิสระ เมธอดที่เป็น idempotent สามารถลองใหม่ได้หลังจากเครือข่ายล้มเหลวโดยไม่มีผลข้างเคียง ซึ่งเป็นสิ่งที่พร็อกซีและ HTTP client สันนิษฐานไว้พอดี และความสามารถในการแคชกำหนดว่าการตอบกลับจะถูกจัดเก็บและนำกลับมาใช้ได้หรือไม่

การค้นหาจับคู่ทั้งชื่อเมธอด คุณสมบัติ และกรณีใช้งาน เช่น PATCH, idempotent และ cache ล้วนกรองตารางได้ และมีสวิตช์กลุ่มแยกเมธอดมาตรฐานออกจากชุด WebDAV ชื่อเมธอดแต่ละตัวคัดลอกไปยังคลิปบอร์ดได้ด้วยคลิกเดียว

วิธีใช้ เมธอด HTTP

  1. สแกนตารางเพื่อเปรียบเทียบเมธอดในคอลัมน์ Safe, Idempotent, Cacheable และ Body
  2. ค้นหาด้วยชื่อ คุณสมบัติ หรือกรณีใช้งาน เช่น PUT, idempotent หรือ upload
  3. สลับระหว่างกลุ่ม Standard และ WebDAV เพื่อรวมหรือแยกเมธอดส่วนขยายออก
  4. วางเมาส์บนทูลทิปของคอลัมน์เพื่อดูคำนิยามของแต่ละคุณสมบัติแบบเข้าใจง่าย
  5. คลิกปุ่มคัดลอกเพื่อนำชื่อเมธอดไปใช้ในสเปก API หรือการทดสอบของคุณ

คำถามที่พบบ่อย

ปลอดภัยหมายความว่าคำขอไม่เปลี่ยนสถานะของเซิร์ฟเวอร์เลย GET และ HEAD เป็นแบบอ่านอย่างเดียว ส่วน idempotent หมายความว่าการทำคำขอเดิมซ้ำ ๆ ให้ผลเช่นเดียวกับการส่งครั้งเดียว DELETE เป็น idempotent แต่ไม่ปลอดภัย เพราะการเรียกครั้งแรกเปลี่ยนสถานะจริง

PUT จะแทนที่ทรัพยากรทั้งหมดด้วย body ที่คุณส่งไป และเป็น idempotent ส่วน PATCH จะปรับแก้บางส่วน เฉพาะฟิลด์ที่คุณระบุเท่านั้นที่เปลี่ยน และไม่รับประกันว่าเป็น idempotent ใช้ PUT สำหรับการแทนที่ทั้งหมดและ PATCH สำหรับการอัปเดตแบบเจาะจง

เพราะไคลเอนต์ พร็อกซี และ SDK จะลองคำขอที่เป็น idempotent ใหม่โดยอัตโนมัติหลังจากหมดเวลาหรือการเชื่อมต่อหลุด คำขอ POST ที่ไม่ใช่ idempotent หากถูกลองใหม่โดยไม่ระวังอาจสร้างคำสั่งซื้อหรือระเบียนซ้ำซ้อนได้ ซึ่งเป็นเหตุผลที่ API การชำระเงินมักใช้ POST คู่กับ idempotency key

การตอบกลับของ GET และ HEAD แคชได้โดยค่าเริ่มต้น ส่วนการตอบกลับของ POST จะแคชได้ก็ต่อเมื่อมีเฮดเดอร์ความสดใหม่ระบุไว้ชัดเจน ซึ่งในทางปฏิบัติพบได้น้อย เมธอดอื่น ๆ ไม่สามารถแคชได้ การตอบกลับของเมธอดเหล่านั้นต้องไม่ถูกจัดเก็บและนำกลับมาใช้ใหม่

WebDAV ขยาย HTTP สำหรับการจัดการไฟล์ระยะไกล โดยเพิ่มเมธอดต่าง ๆ เช่น PROPFIND, MKCOL, COPY, MOVE, LOCK และ UNLOCK คุณจะพบเมธอดเหล่านี้เมื่อทำงานกับเซิร์ฟเวอร์ WebDAV โปรโตคอลปฏิทิน/รายชื่อผู้ติดต่อที่สร้างขึ้นบนพื้นฐานนี้ หรือการเชื่อมต่อไดรฟ์เครือข่าย

ใช่ ทั้งตารางฟรีและทำงานในเบราว์เซอร์ของคุณจากชุดข้อมูลในตัว การค้นหาและกรองไม่ส่งข้อมูลใดไปยังเซิร์ฟเวอร์

แชร์สิ่งนี้
ต้องการความช่วยเหลือ?
พบปัญหากับเครื่องมือนี้หรือไม่? แจ้งทีมงานของเรา
รายงานปัญหา

เพิ่มเครื่องมือฟรีนี้ลงในเว็บไซต์ของคุณเอง — คัดลอกและวางโค้ดด้านล่าง