ما هو API وكيف نقوم بإنشاء واجهة برمجية من خلال Flask

إن API في الويب هو عبارة عن واجهة برمجية لخدمة ويب تسمح لنا بالتخاطب مع موارد محددة والتأكد من الصلاحيات قبل عمل إضافة أو تعديل أو إستعلام عنها.

يتم التعريف عنها من خلال عدد من المسارات الخاصة بمورد محدد Endpoint و يرتبط مع كل مسار نوع الطلبية وهي عادة HTTP method المراد القيام بها مع تمرير وسطاء برمجية تحدد المورد عن طريقة رقمه مثلاً لنستطيع عمل تعديل عليه. في حال المورد عبارة عن صورة سيكون له مثلا API التالي:

• جلب صور GET
• إضافة صورة POST
• تعديل PUT
• حذف DELETE

ثم الدالة ضمن المتحكم للاستجابة لها    المسار الخاص بها      نوع الطلبية
GET	          /photos	            index	photos.index
GET	          /photos/create	    create	photos.create
POST	           /photos	            store	photos.store
GET	          /photos/{photo}	    show	photos.show
GET	          /photos/{photo}/edit	    edit	photos.edit
PUT/PATCH	  /photos/{photo}	    update	photos.update
DELETE	           /photos/{photo}	    destroy	photos.destroy

يوجد شرج نظري من هنا:

يمكنك مشاهدة الدرس:

بالنسبة ل FLASK هو إطار ويب خاص بلغة python يمكننا من إنشاء API.

مثلا نعرف دالة للاستجابة لكل مسار يطلبه المستخدم من المتصفح:

@app.route("/")           # طلب المسار الجذر
def home():
    page = 'Home Page'
    return page           # نعيد له الصفحة الافتراضية

# طلب صفحة ما - نعيد له محتوى معين
@app.route("/hello")
def hello():
    return "Hello World!"
  
@app.route("/PHOTOS/{id}")
def hello():
  filename = 'PHOTOS/id.png'
  return send_file(filename, mimetype='image/png')

يمكنك دراسة سلسلة دروس عمل API من خلال Flask من أكاديمية حسوب: