أساسيات REST API

جزء من دورة ويب

يُطلب منك إضافة نقطة نهاية إلى واجهة برمجية قائمة، فتتوقف حائراً عند أول قرار: أهي POST /users/42/deactivate أم PATCH /users/42؟ كلاهما يعمل. وكلاهما سيصل إلى الإنتاج. لكن أحدهما سيبدو بديهياً لمن يأتي بعدك، والآخر سيشعل جدالاً في مراجعة الكود. REST ليست مواصفة تلتزم بها التزاماً حرفياً، بل مجموعة أعراف متى عرفتها استطاع غريب أن يخمّن واجهتك تخميناً صحيحاً من أول محاولة.

تخيّل خزانة ملفات. لكل درج ولكل مجلد عنوان، والعنوان لا يقول أبداً ما الذي تنوي فعله حين تصل إليه. الفعل قرار منفصل: أن تقرأه، أو تستبدله، أو ترميه. وREST تقسم الواجهة البرمجية القسمة نفسها. الرابط عنوان الشيء. وطريقة HTTP هي الفعل. ...