Xây dựng dựng dụng REST API đơn giản với FLASK

Introduction

RestFull API, chắc hẳn các bạn đã nghe đến cái tên này khá nhiều trong cuộc đời người làm lập trình. Việc xây dựng một ứng dụng REST API cũng ko hề khó. Bài viết này, tôi sẽ hướng dẫn các bạn xây dựng một ứng dụng REST API đơn giản sử dụng Flask (một framwork đơn giản, nhẹ nhàng, và cũng rất dễ dàng để học của python).

Trước khi bắt đầu, các bạn có thể tham khảo bài viết này để hiểu rõ hơn về REST API.

Let Get Started!!!

Trước tiên, hãy tạo workspace để chứa source code của bạn chứ nhỉ

$ mkdir flask_example & cd flask_example/

Tiếp theo là tạo môi trường ảo để chạy Python 2.7

flask_example$ virtualenv venv
flask_example$ source venv/bin/activate

Add các files dưới đây vào ứng dụng của bạn.

(venv) flask_example$ touch app.py .gitignore README.md requirements.txt

Bạn có thể thấy, ứng dựng flask đơn giản của bạn sẽ có cấu trúc cơ bản như bên dưới.

├── .gitignore

├── app.py

├── README.md

└── requirements.txt

Với một ứng dụng Flask, dĩ nhiên bạn không thể không cài đặt flask cho ứng dụng của mh

(venv) flask_example$ pip install flask flask-api

Thêm các thư viện đã cài đặt vào file requirements.txt. Bước này rất quan trọng khi bạn thực thiện build lại ứng dụng của mh trên một môi trường khác. Bạn chỉ cần cài đặt lại các thư viện cần thiện thông qua file requirements.txt này là được.

pip freeze > requirements.txt

Mọi thứ khởi đầu có vẻ như đã hoàn thành, giờ chúng ta cùng bắt tay vào code những dòng đầu tiên với Flask.

Hello World!

"Hello World" là đoạn message vô cùng quen thuộc, bây giờ chúng ta cùng viết đoạn script ngắn để trả về message này nhé.

Đầu tiên hãy mở file app.py và làm như sau:

from flask_api import FlaskAPI

app = FlaskAPI(__name__)

@app.route('/')
def helloworld():
    return {
        "message": "Hello World!"
    }

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

chạy ứng dụng của bạn và chờ đợi điều kì diệu .............

(venv) flask_example$ python app.py
 * Serving Flask app "app" (lazy loading)
 * Environment: production
   WARNING: Do not use the development server in a production environment.
   Use a production WSGI server instead.
 * Debug mode: off
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Đoạn code nho nhỏ trên sẽ trả về cho bạn một đoạn json với nội dung như thế này:

HTTP 200 OK
Content-Type: application/json

{
    "message": "Hello World!"
}

Hoặc bạn có thể vào link http://127.0.0.1:5000/ để xem kết quả