كيفية كتابة REST API باستخدام TypeScript في 30 دقيقة

مقدمة: لماذا TypeScript لواجهات REST API؟

تطوير الويب الحديث لا يمكن تصوره بدون إنشاء واجهات API فعالة وآمنة. TypeScript، كإضافة فوق JavaScript، يوفر كتابة ثابتة (static typing)، مما يقلل بشكل كبير من عدد الأخطاء أثناء التنفيذ ويحسن قابلية قراءة الكود. في هذا الدليل، سنوضح كيفية كتابة REST API كامل باستخدام TypeScript في 30 دقيقة فقط. ستتعلم كيفية إعداد المشروع، وإنشاء نقاط النهاية الأساسية، ومعالجة الأخطاء. هذا البرنامج التعليمي مثالي للمطورين المبتدئين الذين يرغبون في إتقان إنشاء تطبيقات الخادم بسرعة.

إعداد البيئة وتثبيت التبعيات

أولاً، تحتاج إلى إنشاء مشروع جديد وتثبيت جميع الحزم اللازمة. تأكد من تثبيت Node.js (الإصدار 18 أو أعلى) و npm.

الخطوة 1: تهيئة المشروع

افتح الطرفية (Terminal) ونفذ الأوامر التالية:

mkdir my-rest-api
cd my-rest-api
npm init -y

الخطوة 2: تثبيت TypeScript والتبعيات

قم بتثبيت TypeScript و Express والأنواع اللازمة:

npm install express
npm install -D typescript @types/node @types/express ts-node nodemon

• express — إطار عمل لإنشاء الخادم.
• typescript — مترجم TypeScript.
• @types/express — أنواع لـ Express.
• ts-node — لتشغيل TypeScript مباشرة.
• nodemon — إعادة تشغيل الخادم تلقائيًا عند التغييرات.

الخطوة 3: إعداد tsconfig.json

أنشئ ملف tsconfig.json في جذر المشروع:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

إنشاء خادم أساسي باستخدام TypeScript

الآن سنقوم بإنشاء هيكل المجلدات والملف الرئيسي للخادم.

الخطوة 4: هيكل المشروع

أنشئ مجلد src وملف src/index.ts:

mkdir src
touch src/index.ts

الخطوة 5: كتابة الخادم

افتح src/index.ts وأضف الكود التالي:

import express, { Request, Response } from 'express';

const app = express();
const PORT = process.env.PORT || 3000;

// Middleware لتحليل JSON
app.use(express.json());

// المسار الأساسي
app.get('/', (req: Request, res: Response) => {
    res.send('REST API على TypeScript يعمل!');
});

// تشغيل الخادم
app.listen(PORT, () => {
    console.log(`الخادم يعمل على المنفذ ${PORT}`);
});

الخطوة 6: إضافة السكريبتات إلى package.json

قم بتحديث package.json بإضافة سكريبتات للتطوير والبناء:

"scripts": {
  "dev": "nodemon --exec ts-node src/index.ts",
  "build": "tsc",
  "start": "node dist/index.js"
}

الآن قم بتشغيل الخادم باستخدام الأمر npm run dev. يجب أن ترى رسالة "الخادم يعمل على المنفذ 3000".

تنفيذ نقاط نهاية CRUD

سنقوم بإنشاء نموذج بيانات بسيط وتنفيذ عمليات الإنشاء والقراءة والتحديث والحذف (CRUD). كمثال، سنأخذ كيان "مهمة" (Task).

الخطوة 7: إنشاء النموذج والتخزين

أنشئ ملف src/models/Task.ts:

export interface Task {
    id: number;
    title: string;
    completed: boolean;
}

// تخزين مؤقت في الذاكرة
export const tasks: Task[] = [
    { id: 1, title: 'تعلم TypeScript', completed: false },
    { id: 2, title: 'كتابة REST API', completed: false },
];

الخطوة 8: إنشاء المسارات

أنشئ ملف src/routes/tasks.ts:

import { Router, Request, Response } from
```