ค้นหารหัสสถานะ HTTP

ค้นหารหัสสถานะ HTTP ใดก็ได้ — 200, 404, 500 และทุกรหัสระหว่างนั้น — พร้อมคำอธิบายเข้าใจง่ายว่ามันหมายถึงอะไรและเซิร์ฟเวอร์ส่งกลับเมื่อไร

ค้นหารหัสสถานะ HTTP คืออะไร?

รหัสสถานะ HTTP คือตัวเลขสามหลักที่เว็บเซิร์ฟเวอร์ส่งกลับมาพร้อมกับทุกการตอบสนอง เพื่อบอกไคลเอนต์ (เบราว์เซอร์ แอป หรือผู้ใช้ API) ว่าคำขอสำเร็จ ต้องการการเปลี่ยนเส้นทาง หรือล้มเหลว — และเพราะเหตุใด รหัสเหล่านี้ถูกกำหนดมาตรฐานโดย IETF และใช้เหมือนกันในทุกเว็บเซิร์ฟเวอร์ เบราว์เซอร์ และภาษาโปรแกรม ทำให้เป็นหนึ่งในเอกสารอ้างอิงสำหรับการดีบักที่เป็นสากลที่สุดในการพัฒนาซอฟต์แวร์

เครื่องมือค้นหานี้ครอบคลุมรหัสที่พบบ่อยที่สุดในทั้งห้าหมวดหมู่ — ข้อมูลแจ้งเตือน (1xx), สำเร็จ (2xx), เปลี่ยนเส้นทาง (3xx), ข้อผิดพลาดจากไคลเอนต์ (4xx) และข้อผิดพลาดจากเซิร์ฟเวอร์ (5xx) — พร้อมคำอธิบายเข้าใจง่ายว่าแต่ละรหัสหมายถึงอะไรจริงๆ ในทางปฏิบัติ ไม่ใช่แค่คำนิยามทางการจาก RFC เท่านั้น

สูตร

1xx: ข้อมูลแจ้งเตือน — ได้รับคำขอแล้ว กำลังดำเนินการต่อ

2xx: สำเร็จ — ได้รับและยอมรับคำขอสำเร็จ

3xx: เปลี่ยนเส้นทาง — ต้องดำเนินการเพิ่มเติมเพื่อให้คำขอสำเร็จ

4xx: ข้อผิดพลาดจากไคลเอนต์ — คำขอมีรูปแบบไม่ถูกต้องหรือไม่สามารถทำได้

5xx: ข้อผิดพลาดจากเซิร์ฟเวอร์ — เซิร์ฟเวอร์ล้มเหลวในการตอบสนองคำขอที่ถูกต้อง

วิธีคำนวณ

พิมพ์รหัสสถานะ (เช่น 404) หรือคำสำคัญ (เช่น "forbidden") ลงในช่องค้นหา
กรองตามหมวดหมู่โดยใช้ปุ่ม 1xx-5xx หากต้องการเรียกดูช่วงใดช่วงหนึ่งโดยเฉพาะ
อ่านคำอธิบายเข้าใจง่ายว่ารหัสนั้นหมายถึงอะไรและโดยปกติถูกส่งกลับเมื่อไร
ใช้เป็นเอกสารอ้างอิงด่วนขณะดีบักการตอบสนองของ API หรือสร้างระบบจัดการข้อผิดพลาด

ตัวอย่าง

การค้นหา "429" จะแสดงผล "Too Many Requests" — รหัสที่ API ส่งกลับเมื่อคุณเกินขีดจำกัดอัตราการเรียกใช้ บอกให้คุณชะลอและลองใหม่หลังจากรอสักครู่

ประโยชน์หลัก

รหัสสถานะที่ใช้บ่อยทุกตัวรวมอยู่ในเอกสารอ้างอิงที่ค้นหาได้ที่เดียว
คำอธิบายเข้าใจง่าย ไม่ใช่แค่ถ้อยคำทางการจาก RFC เท่านั้น
กรองตามหมวดหมู่ (1xx ถึง 5xx) ได้ทันที
ใช้งานฟรี รวดเร็ว ไม่ต้องสมัครสมาชิก

ข้อผิดพลาดที่พบบ่อย

ส่ง 200 OK สำหรับคำขอที่ล้มเหลวจริง ทำให้ซ่อนข้อผิดพลาดจากเครื่องมือตรวจสอบ
สับสนระหว่าง 401 (ยังไม่ยืนยันตัวตน) กับ 403 (ยืนยันตัวตนแล้วแต่ไม่มีสิทธิ์)
ใช้ 302 สำหรับการเปลี่ยนเส้นทางที่ควรเป็นแบบถาวร (301) ซึ่งส่งผลเสียต่อ SEO
จัดการข้อผิดพลาด 4xx และ 5xx ทั้งหมดเหมือนกันในฝั่งไคลเอนต์แทนที่จะแยกตามรหัสเฉพาะ

เคล็ดลับ

สงวนรหัส 5xx ไว้สำหรับความล้มเหลวฝั่งเซิร์ฟเวอร์เท่านั้น — อย่าใช้เพื่อบ่งบอกข้อผิดพลาดจากการป้อนข้อมูลของไคลเอนต์
ใช้ 429 พร้อมส่วนหัว Retry-After เมื่อจำกัดอัตราการเรียกใช้ เพื่อให้ไคลเอนต์ที่ทำงานอย่างถูกต้องรู้ว่าควรลองใหม่เมื่อไร
เลือกใช้ 404 แทนหน้าข้อผิดพลาดทั่วไปเมื่อทรัพยากรนั้นไม่มีอยู่จริง — ดีกว่าทั้งต่อผู้ใช้และเสิร์ชเอนจิน
เมื่อออกแบบ API ให้เลือกรหัส 4xx ที่เฉพาะเจาะจง (422, 409, 400) แทนที่จะใช้ 400 ทั่วไปสำหรับทุกกรณี

คำศัพท์สำคัญ

Status line: บรรทัดแรกของการตอบสนอง HTTP ซึ่งประกอบด้วยรหัสสถานะและวลีเหตุผลสั้นๆ
Idempotent: คุณสมบัติของบางเมธอด HTTP ที่การทำคำขอเดิมซ้ำมีผลเช่นเดียวกับการทำเพียงครั้งเดียว
Redirect chain: ลำดับของการเปลี่ยนเส้นทางหลายครั้งที่เบราว์เซอร์ทำตามก่อนถึงทรัพยากรสุดท้าย
Rate limiting: การจำกัดจำนวนคำขอที่ไคลเอนต์สามารถทำได้ในช่วงเวลาหนึ่ง มักบ่งบอกด้วยรหัส 429

กรณีใช้งานทั่วไป

ทำความเข้าใจรหัสสถานะที่ไม่คุ้นเคยซึ่งส่งกลับมาจาก API ที่กำลังเชื่อมต่ออยู่ได้อย่างรวดเร็ว
ตัดสินใจว่าจะส่งรหัสสถานะใดกลับจาก API ของตัวเองสำหรับเงื่อนไขข้อผิดพลาดหนึ่งๆ
แก้ไขปัญหาว่าทำไมคำขอถึงล้มเหลว โดยตรวจสอบว่ารหัสหนึ่งๆ หมายความว่าอะไรจริงๆ
สอนหรือเรียนรู้พื้นฐาน HTTP ในหลักสูตรพัฒนาเว็บ
เขียนตรรกะจัดการข้อผิดพลาดที่แม่นยำ แยกแยะระหว่างกรณี 4xx และ 5xx ต่างๆ

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

ช่วงรหัสสถานะ HTTP ต่างๆ หมายถึงอะไรบ้าง?

รหัส 1xx เป็นข้อมูลแจ้งเตือน, 2xx หมายถึงสำเร็จ, 3xx บ่งบอกการเปลี่ยนเส้นทาง, 4xx หมายถึงไคลเอนต์เป็นฝ่ายทำผิดพลาด (เช่น ขอหน้าที่ไม่มีอยู่) และ 5xx หมายถึงเซิร์ฟเวอร์เองล้มเหลวในการตอบสนองคำขอที่ถูกต้อง

401 กับ 403 ต่างกันอย่างไร?

401 Unauthorized หมายถึงคุณยังไม่ได้ยืนยันตัวตน (หรือข้อมูลยืนยันตัวตนไม่ถูกต้อง) — เซิร์ฟเวอร์ไม่รู้ว่าคุณเป็นใคร ส่วน 403 Forbidden หมายถึงเซิร์ฟเวอร์รู้ว่าคุณเป็นใครแต่คุณไม่มีสิทธิ์เข้าถึงทรัพยากรนั้น

ทำไมบางครั้งจึงเห็น 200 สำหรับหน้าที่โหลดไม่สำเร็จอย่างชัดเจน?

โดยปกติหมายความว่าเซิร์ฟเวอร์ส่งการตอบสนอง HTTP ที่ถูกต้องกลับมา (จึงได้ 200 OK) แต่เนื้อหาระดับแอปพลิเคชันของการตอบสนองนั้นอธิบายข้อผิดพลาด ซึ่งเป็นรูปแบบที่พบบ่อยใน API ที่ใส่รายละเอียดข้อผิดพลาดไว้ในเนื้อหาการตอบสนองแทนที่จะใส่ไว้ในรหัสสถานะ

การเปลี่ยนเส้นทาง 301 กับ 302 ต่างกันอย่างไร?

301 Moved Permanently บอกให้เบราว์เซอร์และเสิร์ชเอนจินอัปเดตบันทึกของตนและใช้ URL ใหม่ต่อไปในอนาคต ส่วน 302 Found บ่งบอกการเปลี่ยนเส้นทางชั่วคราว — ควรใช้ URL เดิมสำหรับคำขอในอนาคตต่อไป