ساخت وب‌سرویس برای موبایل با پایتون

در دنیای امروز، اپلیکیشن‌های موبایل نقش حیاتی در زندگی روزمره ما ایفا می‌کنند. بسیاری از این اپلیکیشن‌ها برای دریافت و ارسال داده‌ها به یک سرور مرکزی نیاز دارند. اینجاست که وب‌سرویس‌ها وارد عمل می‌شوند. وب‌سرویس‌ها به عنوان رابطی بین اپلیکیشن موبایل و پایگاه داده یا سیستم‌های پشتیبان عمل می‌کنند. در این مقاله، به بررسی نحوه ساخت وب‌سرویس برای موبایل با استفاده از پایتون خواهیم پرداخت. این آموزش در دسته ‘توسعه وب با پایتون’ قرار می‌گیرد و برای توسعه‌دهندگانی که قصد دارند اپلیکیشن‌های موبایل خود را با پایتون پشتیبانی کنند، مفید خواهد بود.

مقدمه‌ای بر وب‌سرویس‌ها و API

وب‌سرویس‌ها به مجموعه‌ای از پروتکل‌ها و استانداردهایی اشاره دارند که امکان تبادل داده بین برنامه‌های مختلف را فراهم می‌کنند. این تبادل داده معمولاً از طریق اینترنت انجام می‌شود. API (Application Programming Interface) رابطی است که به برنامه‌ها اجازه می‌دهد تا به قابلیت‌های یک وب‌سرویس دسترسی پیدا کنند. به عبارت دیگر، API مجموعه‌ای از قوانین و مشخصات است که نحوه تعامل با وب‌سرویس را تعیین می‌کند.

دو نوع اصلی وب‌سرویس وجود دارد: SOAP و REST. SOAP (Simple Object Access Protocol) یک پروتکل پیچیده‌تر و مبتنی بر XML است. REST (Representational State Transfer) یک سبک معماری ساده‌تر و انعطاف‌پذیرتر است که معمولاً از JSON برای تبادل داده استفاده می‌کند. به دلیل سادگی و کارایی، REST در توسعه وب‌سرویس‌های موبایل بسیار محبوب‌تر است.

انتخاب فریم‌ورک پایتون

پایتون فریم‌ورک‌های متعددی برای ساخت وب‌سرویس‌های RESTful ارائه می‌دهد. برخی از محبوب‌ترین این فریم‌ورک‌ها عبارتند از:

• Flask: یک فریم‌ورک سبک و انعطاف‌پذیر که برای پروژه‌های کوچک و متوسط مناسب است.
• Django: یک فریم‌ورک قدرتمند و کامل که برای پروژه‌های بزرگ و پیچیده مناسب است.
• FastAPI: یک فریم‌ورک مدرن و سریع که بر اساس استاندارد‌های Type Hints پایتون ساخته شده است.

در این آموزش، از Flask به دلیل سادگی و سهولت استفاده، استفاده خواهیم کرد.

نصب Flask

برای نصب Flask، می‌توانید از pip، مدیر بسته پایتون، استفاده کنید. دستور زیر را در ترمینال خود اجرا کنید:

pip install Flask

ساخت یک وب‌سرویس ساده با Flask

حالا بیایید یک وب‌سرویس ساده با Flask بسازیم. یک فایل پایتون به نام app.py ایجاد کنید و کد زیر را در آن قرار دهید:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/users', methods=['GET'])
def get_users():
    users = [
        {'id': 1, 'name': 'علی'},
        {'id': 2, 'name': 'محمد'},
        {'id': 3, 'name': 'رضا'}
    ]
    return jsonify(users)

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

در این کد:

• from flask import Flask, jsonify: ماژول‌های Flask و jsonify را وارد می‌کنیم.
• app = Flask(__name__): یک نمونه از کلاس Flask ایجاد می‌کنیم.
• @app.route('/api/users', methods=['GET']): یک مسیر (route) برای درخواست‌های GET به آدرس /api/users تعریف می‌کنیم.
• def get_users():: تابعی که هنگام دریافت درخواست GET به مسیر /api/users اجرا می‌شود.
• users = [...]: یک لیست از کاربران را تعریف می‌کنیم.
• return jsonify(users): لیست کاربران را به فرمت JSON تبدیل کرده و به عنوان پاسخ ارسال می‌کنیم.
• if __name__ == '__main__': app.run(debug=True): سرور Flask را اجرا می‌کنیم.

برای اجرای این وب‌سرویس، فایل app.py را در ترمینال خود اجرا کنید:

python app.py

حالا می‌توانید با استفاده از یک مرورگر وب یا یک ابزار مانند Postman به آدرس http://127.0.0.1:5000/api/users دسترسی پیدا کنید. شما باید یک لیست از کاربران را در فرمت JSON مشاهده کنید.

افزودن قابلیت‌های بیشتر

حالا بیایید قابلیت‌های بیشتری به وب‌سرویس خود اضافه کنیم. به عنوان مثال، می‌توانیم یک مسیر برای دریافت اطلاعات یک کاربر خاص بر اساس ID آن ایجاد کنیم:

@app.route('/api/users/', methods=['GET'])
def get_user(user_id):
    users = [
        {'id': 1, 'name': 'علی'},
        {'id': 2, 'name': 'محمد'},
        {'id': 3, 'name': 'رضا'}
    ]
    for user in users:
        if user['id'] == user_id:
            return jsonify(user)
    return jsonify({'message': 'User not found'}), 404

در این کد:

• @app.route('/api/users/', methods=['GET']): یک مسیر برای درخواست‌های GET به آدرس /api/users/{user_id} تعریف می‌کنیم. یک پارامتر متغیر است که ID کاربر را دریافت می‌کند.
• def get_user(user_id):: تابعی که هنگام دریافت درخواست GET به مسیر /api/users/{user_id} اجرا می‌شود.
• for user in users: if user['id'] == user_id: return jsonify(user): لیست کاربران را پیمایش می‌کنیم و اگر کاربری با ID مورد نظر پیدا کردیم، اطلاعات آن را به فرمت JSON تبدیل کرده و به عنوان پاسخ ارسال می‌کنیم.
• return jsonify({'message': 'User not found'}), 404: اگر کاربری با ID مورد نظر پیدا نشد، یک پیام خطا را به فرمت JSON تبدیل کرده و با کد وضعیت 404 (Not Found) ارسال می‌کنیم.

حالا می‌توانید با استفاده از یک مرورگر وب یا یک ابزار مانند Postman به آدرس http://127.0.0.1:5000/api/users/1 دسترسی پیدا کنید. شما باید اطلاعات کاربر با ID 1 را در فرمت JSON مشاهده کنید.

ارتباط با پایگاه داده

در بیشتر موارد، وب‌سرویس‌ها برای دریافت و ارسال داده‌ها به یک پایگاه داده متصل می‌شوند. برای اتصال به پایگاه داده، می‌توانید از کتابخانه‌های مختلف پایتون استفاده کنید. به عنوان مثال، برای اتصال به پایگاه داده MySQL می‌توانید از کتابخانه mysql-connector-python استفاده کنید.

برای استفاده از این کتابخانه، ابتدا آن را نصب کنید:

pip install mysql-connector-python

سپس می‌توانید از آن برای اتصال به پایگاه داده و اجرای کوئری‌ها استفاده کنید. به عنوان مثال:

import mysql.connector

mydb = mysql.connector.connect(
  host="localhost",
  user="yourusername",
  password="yourpassword",
  database="yourdatabase"
)

mycursor = mydb.cursor()

mycursor.execute("SELECT * FROM users")

myresult = mycursor.fetchall()

for x in myresult:
  print(x)

در این کد:

• import mysql.connector: ماژول mysql.connector را وارد می‌کنیم.
• mydb = mysql.connector.connect(...): به پایگاه داده MySQL متصل می‌شویم.
• mycursor = mydb.cursor(): یک شی cursor ایجاد می‌کنیم.
• mycursor.execute("SELECT * FROM users"): یک کوئری SQL را اجرا می‌کنیم.
• myresult = mycursor.fetchall(): نتایج کوئری را دریافت می‌کنیم.
• for x in myresult: print(x): نتایج را چاپ می‌کنیم.

شما می‌توانید این کد را در وب‌سرویس خود استفاده کنید تا داده‌ها را از پایگاه داده دریافت کرده و به عنوان پاسخ ارسال کنید.

امنیت وب‌سرویس

امنیت وب‌سرویس‌ها بسیار مهم است. برای افزایش امنیت وب‌سرویس خود، می‌توانید از روش‌های مختلفی استفاده کنید، از جمله:

• استفاده از HTTPS: برای رمزنگاری ارتباط بین اپلیکیشن موبایل و وب‌سرویس.
• احراز هویت (Authentication): برای تأیید هویت کاربران.
• مجوزدهی (Authorization): برای تعیین دسترسی کاربران به منابع مختلف.
• اعتبارسنجی ورودی (Input Validation): برای جلوگیری از حملات تزریقی (Injection Attacks).
• محدود کردن نرخ درخواست (Rate Limiting): برای جلوگیری از حملات DDoS.

نتیجه‌گیری

در این مقاله، به بررسی نحوه ساخت وب‌سرویس برای موبایل با استفاده از پایتون و Flask پرداختیم. ما یاد گرفتیم که چگونه یک وب‌سرویس ساده ایجاد کنیم، قابلیت‌های بیشتری به آن اضافه کنیم، به پایگاه داده متصل شویم و امنیت آن را افزایش دهیم. با استفاده از این دانش، می‌توانید وب‌سرویس‌های قدرتمندی را برای اپلیکیشن‌های موبایل خود ایجاد کنید.