شرح صفوف ومحتوى الفقرة
طريقة HTTP PUT تُستخدم عادةً لتحميل أو تحديث البيانات على الخادم، وتهدف هذه الطريقة إلى إرسال بيانات معينة إلى الخادم وإجراء عمليات تخزين تلك البيانات بشكل كامل، أي أنه يتم استبدال البيانات الموجودة بالبيانات الجديدة التي يتم إرسالها، وتتميز هذه الطريقة بأنها ثابتة، أي idempotent: تكرار الطلب نفسه له الأثر المقصود نفسه على حالة المورد. قد تختلف الاستجابة وسجلات الطلبات بين المحاولات، ولكن من غير الممكن تخزين استجابات PUT مؤقتًا.
كيفية استخدام طريقة PUT في HTTP
طريقة HTTP PUT تُستخدم لإرسال بيانات العميل إلى الخادم بغرض إنشاء مورد جديد أو استبدال تمثيل مورد موجود في المسار المحدد بـ "<request-target>". تُرسل البيانات عادةً في جسم الطلب، ويمكن استخدام "?<query>" لإضافة استفسارات في عنوان URL إذا لزم الأمر، ويشير "HTTP/1.1" إلى إصدار البروتوكول المستخدم.
How to use PUT method in HTTP
طريقة استخدام PUT في HTTP.
PUT <request-target>["?"<query>] HTTP/1.1HTTP PUT Request Method
استخدام طريقة HTTP PUT لتحديث أو إنشاء بيانات موظف ببيانات JSON في نظام إدارة.
PUT /employees/123 HTTP/1.1
Host: www.closetag.com
Content-Type: application/json
Content-Length: 89
{
"name": "Ahmed Ali",
"position": "Project Manager",
"email": "[email protected]"
}HTTP response message from server
رسالة الاستجابة response تُشير إلى أن الطلب تم تنفيذه بنجاح وأن الموظف موجود وتم تحديث بياناته.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 160
{
"message": "Employee updated successfully",
"employee": {
"id": 123,
"name": "Ahmed Ali",
"position": "Project Manager",
"email": "[email protected]"
}
}