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": "[email protected]"

} ```

سيؤدي هذا إلى استبدال جميع معلومات المستخدم 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 للحصول على معلومات أكثر تفصيلاً: [[1]]

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

ابدأ التداول الآن

سجل في IQ Option (الحد الأدنى للإيداع $10) افتح حساباً في Pocket Option (الحد الأدنى للإيداع $5)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin للحصول على: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات باتجاهات السوق ✓ مواد تعليمية للمبتدئين