Danh sách HTTP Status Code và Hướng dẫn sử dụng

1. HTTP Status Code là gì?

HTTP Status Code (Mã trạng thái HTTP) là một mã ba chữ số mà máy chủ gửi lại cho client để chỉ ra trạng thái của yêu cầu (request) sau khi yêu cầu này được phía máy chủ xử lý. Status-Line là một phần của phản hồi HTTP, chứa thông tin về phiên bản HTTP, mã trạng thái, và lý do (reason phrase), cú pháp của Status-Line là: <HTTP-Version> <Status-Code> <Reason-Phrase> CRLF

HTTP Status Code được chia làm 5 nhóm chính:

1. 1xx Informational (Thông tin): Cung cấp thông tin ở mức giao thức truyền tải.
2. 2xx Success (Thành công): Cho biết yêu cầu từ client đã được nhận, hiểu và chấp nhận thành công.
3. 3xx Redirection (Chuyển hướng): Cho biết cần thực hiện thêm một hành động nào đó để hoàn thành yêu cầu.
4. 4xx Client Error (Lỗi từ phía client): Cho biết có lỗi xảy ra do yêu cầu không đúng từ phía client.
5. 5xx Server Error (Lỗi từ phía server): Cho biết server gặp lỗi khi xử lý yêu cầu và không thể hoàn thành được.

Các mã trạng thái 2xx và 3xx được xem là thành công và 4xx và 5xx là lỗi.

2. Danh sách HTTP Status Code phổ biến

3. Hướng dẫn trả về Status Code trong Reponse

Khi yêu cầu được xử lý thành công, bạn có thể trả về một phản hồi với mã trạng thái 200.

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/success', methods=['GET'])
def success_response():
    data = {
        'message': 'Yêu cầu đã được xử lý thành công.',
        'data': {
            'key': 'value'
        }
    }
    return jsonify(data), 200

if __name__ == '__main__':
    app.run(debug=True)

Khi tài nguyên không được tìm thấy, bạn có thể trả về một phản hồi với mã trạng thái 404

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/resource/<int:id>', methods=['GET'])
def get_resource(id):
    resources = {
        1: 'Resource 1',
        2: 'Resource 2'
    }
    if id in resources:
        return jsonify({'resource': resources[id]}), 200
    else:
        return jsonify({'error': 'Resource not found'}), 404

if __name__ == '__main__':
    app.run(debug=True)

Khi máy chủ gặp lỗi phản hồi từ một máy chủ phụ trợ (upstream server), bạn có thể trả về một phản hồi với mã trạng thái 502.

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/proxy', methods=['GET'])
def proxy_request():
    # Giả lập việc gọi một dịch vụ phụ trợ
    backend_response = None  # Giả sử phản hồi từ backend là None do lỗi

    if backend_response is None:
        return jsonify({'error': 'Bad Gateway. Backend server failed to respond.'}), 502
    else:
        return jsonify({'data': backend_response}), 200

if __name__ == '__main__':
    app.run(debug=True)

4. Kết luận

Trong lập trình web và phát triển ứng dụng, việc hiểu rõ và sử dụng chính xác các mã trạng thái HTTP (HTTP Status Codes) là vô cùng quan trọng. Mã trạng thái không chỉ giúp xác định kết quả của một yêu cầu HTTP mà còn cung cấp thông tin chi tiết về việc xử lý yêu cầu đó, giúp người dùng và lập trình viên hiểu rõ hơn về tình trạng và nguyên nhân của các vấn đề có thể xảy ra.

Các bài viết liên quan tại Blog 200Lab:

• IDE là gì? Những công cụ IDE phổ biến nhất hiện nay
• JWT là gì? Các thành phần chính trong JWT
• SOLID là gì? Lập trình Hướng đối tượng hiệu quả hơn với Nguyên lý SOLID
• SSL/ TLS và HTTPS là gì? Giải pháp Bảo mật cho kết nối Web an toàn