View source for MDN Web Docs - PUT

=== MDN Web Docs - PUT ===

'''طريقة PUT''' هي إحدى طرق [[أفعال HTTP]] القياسية، وتستخدم لإرسال بيانات جديدة إلى [[خادم الويب]]، أو لتحديث بيانات موجودة. على عكس طريقة [[POST]]، فإن طريقة PUT تتطلب تحديد المورد (resource) بشكل كامل، وتستبدل المورد بالكامل بالبيانات المرسلة. هذه المقالة موجهة للمبتدئين وتهدف إلى شرح طريقة PUT بالتفصيل، مع التركيز على استخداماتها في سياق [[واجهات برمجة التطبيقات للويب]].

== الغرض من طريقة PUT ==

الهدف الأساسي من طريقة PUT هو إنشاء أو استبدال مورد في [[عنوان URL]] المحدد. إذا كان المورد موجودًا بالفعل، فسيتم استبداله بالبيانات الجديدة. إذا لم يكن المورد موجودًا، فسيتم إنشاؤه.  هذا يختلف عن POST، حيث POST غالبًا ما يستخدم لإنشاء موارد جديدة بشكل غير محدد (على سبيل المثال، إرسال نموذج).

== بنية طلب PUT ==

يجب أن يتضمن طلب PUT:

* '''طريقة HTTP:''' PUT
* '''عنوان URL:'''  يمثل المورد الذي سيتم استبداله أو إنشاؤه.
* '''رؤوس (Headers):'''  تتضمن معلومات حول الطلب، مثل نوع المحتوى (Content-Type).
* '''نص الطلب (Request Body):''' يحتوي على البيانات الجديدة التي سيتم استخدامها لاستبدال المورد. يجب أن يكون نص الطلب بتنسيق مناسب، مثل [[JSON]] أو [[XML]].

مثال على رأس (Header) لطلب PUT:

'''Content-Type: application/json'''

== مثال عملي ==

لنفترض أن لدينا موردًا يمثل مستخدمًا في قاعدة البيانات، وعنوان URL الخاص به هو:

'''/users/123'''

لنفترض أننا نريد تحديث معلومات هذا المستخدم. يمكننا استخدام طريقة PUT مع نص الطلب التالي (بتنسيق JSON):

```json
{
  "name": "أحمد جديد",
  "email": "ahmad.jadeed@example.com"
}
```

سيؤدي هذا إلى استبدال جميع معلومات المستخدم 123 بالبيانات الجديدة المحددة في نص الطلب.

== الاختلافات بين PUT و POST ==

| الميزة | PUT | POST |
|---|---|---|
| **الغرض** | استبدال أو إنشاء مورد محدد | إنشاء مورد جديد بشكل غير محدد |
| **تحديد المورد** | يتطلب تحديد المورد بشكل كامل في عنوان URL | لا يتطلب تحديد المورد بشكل كامل |
| **الاستبدال** | يستبدل المورد بالكامل | غالبًا ما يضيف بيانات جديدة إلى المورد |
| **الآثار الجانبية** | يجب أن يكون [[Idempotent]] (أي، تكرار الطلب له نفس النتيجة) | ليس بالضرورة [[Idempotent]] |

== آثَار Idempotency ==

كما ذكرنا، يجب أن تكون طريقة PUT [[Idempotent]]. هذا يعني أنه إذا قمت بتكرار نفس طلب PUT عدة مرات، يجب أن تكون النتيجة هي نفسها كما لو قمت بإرسال الطلب مرة واحدة فقط.  هذا مهم لضمان موثوقية [[واجهات برمجة التطبيقات]]، خاصة في الحالات التي قد تحدث فيها أخطاء في الشبكة.

== رموز الحالة (Status Codes) الشائعة ==

* '''200 OK:'''  تمت العملية بنجاح.
* '''201 Created:''' تم إنشاء مورد جديد بنجاح (قد يستخدم إذا لم يكن المورد موجودًا من قبل).
* '''204 No Content:'''  تمت العملية بنجاح، ولكن لا يوجد محتوى لإرجاعه.
* '''400 Bad Request:'''  الطلب غير صالح.
* '''404 Not Found:'''  المورد غير موجود.
* '''409 Conflict:'''  تعارض في الطلب (على سبيل المثال، محاولة تحديث مورد تم تعديله بواسطة مستخدم آخر).

== استخدامات طريقة PUT في تداول العملات المشفرة والخيارات الثنائية (على سبيل المثال) ==

على الرغم من أن طريقة PUT لا تستخدم بشكل مباشر في تنفيذ الصفقات في تداول العملات المشفرة أو الخيارات الثنائية، إلا أنها ذات صلة في بناء [[واجهات برمجة التطبيقات]] التي تدعم هذه العمليات. على سبيل المثال:

* '''تحديث أوامر معلقة:'''  يمكن استخدام PUT لتحديث تفاصيل أمر معلق، مثل تعديل سعر الهدف أو وقف الخسارة.
* '''تحديث بيانات الحساب:'''  يمكن استخدام PUT لتحديث معلومات الحساب، مثل عنوان المحفظة أو تفاصيل الدفع.
* '''تحديث إعدادات التداول:'''  يمكن استخدام PUT لتحديث إعدادات التداول، مثل حجم الصفقة أو مستوى المخاطرة.

== استراتيجيات تداول مرتبطة (للمعلومات العامة) ==

* [[Scalping]]:  استراتيجية تداول سريعة الأجل.
* [[Day Trading]]:  استراتيجية تداول تعتمد على الصفقات اليومية.
* [[Swing Trading]]:  استراتيجية تداول تعتمد على الاستفادة من تقلبات الأسعار على مدى أيام أو أسابيع.
* [[Position Trading]]:  استراتيجية تداول طويلة الأجل.
* [[Arbitrage]]:  استراتيجية تداول تستغل فروق الأسعار بين الأسواق المختلفة.
* [[Trend Following]]:  استراتيجية تداول تعتمد على تحديد واتباع الاتجاهات السعرية.
* [[Mean Reversion]]: استراتيجية تعتمد على توقع عودة الأسعار إلى متوسطها.
* [[Breakout Strategy]]: استراتيجية تعتمد على اختراق مستويات الدعم والمقاومة.
* [[Momentum Trading]]: استراتيجية تعتمد على الاستفادة من قوة الاتجاه.
* [[News Trading]]: استراتيجية تعتمد على التداول بناءً على الأخبار والأحداث الاقتصادية.
* [[Options Trading]]: تداول الخيارات.
* [[Binary Options]]: تداول الخيارات الثنائية.
* [[Forex Trading]]: تداول الفوركس.
* [[Cryptocurrency Trading]]: تداول العملات المشفرة.
* [[Algorithmic Trading]]: التداول الخوارزمي.

== التحليل الفني وحجم التداول ==

* [[Moving Averages]]: المتوسطات المتحركة.
* [[Relative Strength Index (RSI)]]: مؤشر القوة النسبية.
* [[MACD]]: مؤشر MACD.
* [[Bollinger Bands]]: نطاقات بولينجر.
* [[Fibonacci Retracements]]: ارتدادات فيبوناتشي.
* [[Volume Weighted Average Price (VWAP)]]: متوسط السعر المرجح بالحجم.
* [[On Balance Volume (OBV)]]: حجم التداول المتوازن.
* [[Accumulation/Distribution Line]]: خط التراكم/التوزيع.
* [[Ichimoku Cloud]]: سحابة إيشيموكو.
* [[Candlestick Patterns]]: أنماط الشموع اليابانية.
* [[Support and Resistance]]: مستويات الدعم والمقاومة.
* [[Chart Patterns]]: أنماط الرسوم البيانية.
* [[Order Flow]]: تدفق الأوامر.
* [[Time and Sales]]: الوقت والمبيعات.
* [[Depth of Market]]: عمق السوق.

== ملاحظات إضافية ==

*  تأكد من أن نص الطلب (Request Body) بتنسيق صحيح ومتوافق مع [[واجهة برمجة التطبيقات]].
*  تعامل مع رموز الحالة (Status Codes) بشكل صحيح لتحديد ما إذا كانت العملية قد نجحت أم لا.
*  ضع في اعتبارك [[الأمان]] عند استخدام طريقة PUT، خاصة عند التعامل مع بيانات حساسة.
*  استخدم [[أدوات اختبار واجهة برمجة التطبيقات]] مثل Postman أو curl لاختبار طلبات PUT.
*  راجع [[وثائق MDN Web Docs]] للحصول على معلومات أكثر تفصيلاً: [[https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT]]

[[HTTP]]
[[RESTful API]]
[[JSON]]
[[XML]]
[[Idempotent]]
[[واجهات برمجة التطبيقات]]
[[أفعال HTTP]]
[[POST]]
[[GET]]
[[DELETE]]
[[PATCH]]
[[Content-Type]]
[[رؤوس HTTP]]
[[رموز الحالة HTTP]]
[[أمان الويب]]
[[اختبار واجهة برمجة التطبيقات]]
[[HTTPS]]
[[OAuth]]
[[API Keys]]

[[Category:الفئة:واجهات برمجة التطبيقات للويب]]

== ابدأ التداول الآن ==
[https://affiliate.iqbroker.com/redir/?aff=1085&instrument=options_WIKI سجل في IQ Option] (الحد الأدنى للإيداع $10)
[http://redir.forex.pm/pocketo افتح حساباً في Pocket Option] (الحد الأدنى للإيداع $5)
=== انضم إلى مجتمعنا ===
اشترك في قناة Telegram الخاصة بنا [https://t.me/strategybin @strategybin] للحصول على:
✓ إشارات تداول يومية
✓ تحليلات استراتيجية حصرية
✓ تنبيهات باتجاهات السوق
✓ مواد تعليمية للمبتدئين