كيف تعمل REST API · خرائط ذهنية
كيف تعمل REST API. خريطة ذهنية قابلة للتحرير تضم فروعًا ملونة وأفكارًا فرعية وروابط. توضح الخطوط المنحنية العلاقات، وتظهر الأسهم حين يكون للاتجاه معنى.
REST API محادثة بلغة HTTP: العميل يرسل طلباً يسمّي مورداً وإجراءً، والخادم يعالجه، والاستجابة تحمل رمز حالة والنتيجة.
كيف تعمل REST API · خرائط ذهنية
لوحة MindMap التفاعلية لهذا الشرح — كل مسار وصف وسهم أعلاه جزء من مخطط QueryChart حقيقي يمكنك فتحه وتعديله.
كيفية قراءة الخريطة الذهنية
- ابدأ بالموضوع في المركز، ثم اتبع أحد الفروع الملونة لاستكشاف الأفكار المرتبطة به.
- توضح الخطوط المنحنية العلاقات، وتظهر الأسهم حين يكون للاتجاه معنى.
Request
يجمع هذا الفرع “The method is the verb — GET reads, POST creates, PUT replaces, PATCH updates, DELETE removes. REST names resources by URL and acts on them with these verbs.”, “Client sends the request over HTTPS”.
Routing
يجمع هذا الفرع “The URL path is the routing key: /users/42 is the handler for one user. Query parameters, headers and the body carry everything else the handler needs.”, “Validation covers authentication (are you who you say you are?), authorization (are you allowed?), and the payload itself (is the data well formed?).”.
Business logic
يجمع هذا الفرع “Handler runs the business logic”, “Server reads or writes the resource in the database”.
Response
يجمع هذا الفرع “The status code is the contract: 200 OK, 201 Created, 204 No Content, 404 Not Found, 500 Server Error. Clients branch on it before they read the body.”, “Client receives the response and parses it”, “Client renders the result to the user”.
Errors
يجمع هذا الفرع “Server returns 400 / 401 / 403”.
روابط بين الفروع
REST عقد بلغة HTTP: الطرق أفعال، وعناوين URL موارد، ورموز الحالة هي النتيجة المقروءة آلياً.
العميل عديم الحالة، فكل طلب يحمل كل ما يحتاجه الخادم، فلا حاجة إلى جلسة مشتركة.
التحقّق هو الحد الأمني الفاصل؛ فالطلب غير الصالح يُرفض قبل تنفيذ أي منطق عمل.
الاستجابة يعرّفها رمز حالتها أولاً وجسمها ثانياً.
حركة REST تركب DNS وHTTPS والبنية التحتية للإنترنت نفسها التي ترسمها الشروحات المرئية التقنية الأخرى.
العلاقات الرئيسية والخلاصات
- REST عقد بلغة HTTP: الطرق أفعال، وعناوين URL موارد، ورموز الحالة هي النتيجة المقروءة آلياً.
- العميل عديم الحالة، فكل طلب يحمل كل ما يحتاجه الخادم، فلا حاجة إلى جلسة مشتركة.
- التحقّق هو الحد الأمني الفاصل؛ فالطلب غير الصالح يُرفض قبل تنفيذ أي منطق عمل.
- الاستجابة يعرّفها رمز حالتها أولاً وجسمها ثانياً.
- حركة REST تركب DNS وHTTPS والبنية التحتية للإنترنت نفسها التي ترسمها الشروحات المرئية التقنية الأخرى.
متى تستخدم هذا الشرح المرئي
- تعليم المهندسين نموذج الطريقة وعنوان URL ورمز الحالة قبل أن يصمّموا أول نقطة نهاية لهم.
- مراجعة عقد أي API (هل الأخطاء رموز حالة أم 200 مع راية في الجسم؟) مقابل عرف REST.
- تأسيس نقاش حول التكرار دون أثر إضافي (idempotency) والتخزين المؤقت على الطريقة التي تُبنى بها الطلبات ويُتحقّق منها فعلاً.
كيف تعمل
عدّل الموضوع المركزي
غيّر اسم الموضوع ليناسب مشروعك أو درسك.
وسّع الفروع
حرر الأفكار وأضف أمثلة أو ملاحظات.
اربط الأفكار ذات الصلة
ارسم روابط بين الفروع، واستخدم الأسهم عندما يكون الاتجاه مهمًا.
الأسئلة الشائعة
ما هو REST API؟
REST API مجموعة من نقاط نهاية HTTP تكشف موارد نظام ما. ويعمل العملاء على الموارد بطرق HTTP (GET للقراءة، وPOST للإنشاء، وPUT أو PATCH للتحديث، وDELETE للحذف) ويردّ الخادم برمز حالة وبتمثيل للمورد، عادةً بصيغة JSON. وREST أسلوب لا معيار، وقيمته أن أي عميل يتكلّم HTTP يستطيع استخدامه.
ما الفرق بين GET وPOST وPUT وDELETE؟
هي أفعال عقد REST. يقرأ GET مورداً ولا ينبغي أن تكون له آثار جانبية. وينشئ POST مورداً جديداً ويعيد هويته. ويستبدل PUT المورد بالكامل، وهو قابل للتكرار دون أثر إضافي، فتكراره لا يغيّر شيئاً بعد المرة الأولى. ويطبّق PATCH تحديثاً جزئياً. ويزيل DELETE مورداً. والفعل مع عنوان URL يسمّيان معاً الإجراء الكامل، ولهذا يُبرز مربع الطلب في الشرح المرئي الطريقة أولاً.
لماذا رموز الحالة مهمة في REST؟
لأنها النتيجة المقروءة آلياً للطلب. فالعميل يستطيع التفرّع بناءً على رمز الحالة دون تحليل الجسم: 2xx نجاح، و4xx خطأ من العميل، و5xx خطأ من الخادم. وواجهات API التي تعيد 200 مع راية خطأ في الجسم تكسر هذا العقد وتجبر كل عميل على معالجة الاستجابة معالجة خاصة.
ما الذي يجعل أي API متوافقاً مع REST؟
القائمة العملية: موارد مسمّاة بعناوين URL، وإجراءات معبَّر عنها بطرق HTTP، وطلبات عديمة الحالة (كل طلب يحمل كل ما يحتاجه الخادم)، واستجابات تستخدم رموز الحالة استخداماً سليماً، وغالباً روابط تشعّبية أو عناوين URL موسومة بالإصدار. وتنمذج اللوحة رحلة الذهاب والعودة (الطلب، والتحقّق، والمعالجة، والاستجابة) وهي الشكل الذي يشترك فيه كل تبادل متوافق مع REST.
حرر هذه الخريطة الذهنية في QueryChart
افتح الخريطة على لوحة قابلة للتحرير. انقل الأفكار وأضف فروعًا وروابط.