You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
46 lines
3.6 KiB
46 lines
3.6 KiB
<!--
|
|
CO_OP_TRANSLATOR_METADATA:
|
|
{
|
|
"original_hash": "9884f8c8a61cf56214450f8b16a094ce",
|
|
"translation_date": "2025-08-26T00:04:03+00:00",
|
|
"source_file": "7-bank-project/api/README.md",
|
|
"language_code": "ar"
|
|
}
|
|
-->
|
|
# واجهة برمجة التطبيقات للبنك
|
|
|
|
> واجهة برمجة التطبيقات للبنك مبنية باستخدام [Node.js](https://nodejs.org) + [Express](https://expressjs.com/).
|
|
|
|
تم بناء واجهة برمجة التطبيقات بالفعل وهي ليست جزءًا من التمرين.
|
|
|
|
ومع ذلك، إذا كنت مهتمًا بتعلم كيفية بناء واجهة برمجة تطبيقات مثل هذه، يمكنك متابعة سلسلة الفيديوهات التالية: https://aka.ms/NodeBeginner (الفيديوهات من 17 إلى 21 تغطي هذه الواجهة بالضبط).
|
|
|
|
يمكنك أيضًا إلقاء نظرة على هذا الدليل التفاعلي: https://aka.ms/learn/express-api
|
|
|
|
## تشغيل الخادم
|
|
|
|
تأكد من تثبيت [Node.js](https://nodejs.org).
|
|
|
|
1. قم باستنساخ هذا المستودع [The Web-Dev-For-Beginners](https://github.com/microsoft/Web-Dev-For-Beginners).
|
|
2. افتح نافذة الأوامر وانتقل إلى المجلد `Web-Dev-For-Beginners/7-bank-project/api`.
|
|
3. قم بتشغيل `npm install` وانتظر حتى يتم تثبيت الحزم (قد يستغرق بعض الوقت حسب جودة اتصالك بالإنترنت).
|
|
4. عند انتهاء التثبيت، قم بتشغيل `npm start` وستكون جاهزًا للعمل.
|
|
|
|
يجب أن يبدأ الخادم في الاستماع على المنفذ `5000`.
|
|
*سيعمل هذا الخادم مع نافذة أوامر الخادم الرئيسية لتطبيق البنك (الذي يستمع على المنفذ `3000`)، لا تقم بإغلاقه.*
|
|
|
|
> ملاحظة: يتم تخزين جميع الإدخالات في الذاكرة ولا يتم حفظها، لذا عند إيقاف الخادم يتم فقدان جميع البيانات.
|
|
|
|
## تفاصيل واجهة برمجة التطبيقات
|
|
|
|
المسار | الوصف
|
|
---------------------------------------------|------------------------------------
|
|
GET /api/ | الحصول على معلومات الخادم
|
|
POST /api/accounts/ | إنشاء حساب، مثال: `{ user: 'Yohan', description: 'My budget', currency: 'EUR', balance: 100 }`
|
|
GET /api/accounts/:user | الحصول على جميع البيانات للحساب المحدد
|
|
DELETE /api/accounts/:user | إزالة الحساب المحدد
|
|
POST /api/accounts/:user/transactions | إضافة معاملة، مثال: `{ date: '2020-07-23T18:25:43.511Z', object: 'Bought a book', amount: -20 }`
|
|
DELETE /api/accounts/:user/transactions/:id | إزالة المعاملة المحددة
|
|
|
|
**إخلاء المسؤولية**:
|
|
تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة. |