تمكِّنك واجهة برمجة تطبيقات StocksTrader من التفاعل مع منصة التداول، ولكن قد تحدث أخطاء إذا لم يتم تشكيل الطلبات بشكل صحيح. يشرح هذا الدليل رموز الأخطاء الأكثر شيوعًا — 400 طلب غير صالح و401 غير مصرح — ويقدم خطوات لحلها.

سيساعدك هذا الدليل على تحديد وحل أخطاء واجهة برمجة التطبيقات الشائعة بسرعة.

رموز الأخطاء الشائعة

1. 400 — طلب غير صالح

ماذا يعني: يحتوي الطلب على خطأ بسبب عنوان URL غير صحيح أو معلمات مفقودة أو غير صالحة أو تنسيق بيانات غير صحيح.

أمثلة:

• استخدام ‎/api/v1/logout/account بدلاً من ‎/api/v1/logout الصحيح
• حقول مطلوبة مفقودة مثل ticker أو volume أو side أو type في طلب POST إلى ‎/api/v1/accounts/{account_id}/orders
• تقديم account_id أو ticker غير صالح في الطلبات مثل ‎/api/v1/accounts/{account_id}/instruments/{ticker}

كيفية الإصلاح:

• تحقق من عنوان URL: تأكد من مطابقته لوثائق واجهة برمجة التطبيقات. مثلاً، استخدم ‎/api/v1/logout بدلاً من ‎/api/v1/logout/account.
• تحقق من المعلمات: تأكد من تضمين جميع المعلمات المطلوبة وصحتها. مثلاً، يجب أن تكون ticker وvolume وside وtype موجودة في طلب POST إلى ‎/api/v1/accounts/{account_id}/orders.
• تحقق من تنسيق البيانات: تأكد من أن جسم الطلب يتبع التنسيق المتوقع.
• راجع الاستجابة: تحقق من الحقل msg في استجابة الخطأ للحصول على تلميحات حول الخطأ.

2. 401 — غير مصرح

ماذا يعني: الطلب يفتقر إلى رمز التفويض الصحيح أو أن الرمز غير صالح.

أمثلة:

• الوصول إلى ‎/api/v1/accounts بدون رمز Bearer
• استخدام رمز منتهي أو غير صالح

كيفية الإصلاح:

• أضف رمز التفويض: قم بإضافة رأس Authorization إلى طلبك.
• تحقق من الرمز: إذا كان الرمز منتهيًا، أنشئ رمزًا جديدًا من خلال منصة StocksTrader على الويب.
• تحقق من الصلاحيات: تأكد من أن الرمز ينتمي إلى حساب لديه صلاحية الوصول إلى المورد المطلوب.

توصيات عامة

• ارجع إلى الوثائق: راجع دائمًا مواصفات واجهة برمجة التطبيقات للحصول على النقاط النهائية الصحيحة والمعلمات وتنسيقات البيانات.
• سجّل الطلبات والاستجابات: احتفظ بنسخة كاملة من الطلب والاستجابة (بما في ذلك الحقل msg) لتحليل الأخطاء.
• اختبر مسبقًا: استخدم أدوات مثل Postman للتحقق من صحة الطلبات قبل النشر.
• اتصل بالدعم: إذا استمرت المشكلة، تواصل مع الدعم الفني وقدِّم تفاصيل الطلب (الرابط، الجسم، والاستجابة).

مثال: تصحيح خطأ 400

المشكلة: تتلقى خطأ 400 عند إرسال طلب POST إلى ‎/api/v1/logout/account.

الحل:

• تحقق من الوثائق: النقطة النهائية الصحيحة هي ‎/api/v1/logout.
• قم بتحديث عنوان URL إلى ‎https://api.stockstrader.com/api/v1/logout.
• تأكد من أنه طلب POST ويحتوي على رأس Authorization الصحيح.
• أعد إرسال الطلب.

مثال: تصحيح خطأ 401

المشكلة: تتلقى خطأ 401 عند إرسال طلب GET إلى ‎/api/v1/accounts لاسترداد قائمة الحسابات الخاصة بك.

الحل:

• تحقق من الرؤوس: تأكد من وجود رأس Authorization.
• إذا كان مفقودًا، أضفه. إذا كان الرمز منتهيًا، أنشئ رمزًا جديدًا من خلال منصة StocksTrader على الويب.
• تأكد من أن الرمز يخص حسابًا لديه صلاحية الوصول إلى ‎/api/v1/accounts.
• أعد إرسال الطلب باستخدام رمز صالح.