یکپارچه سازی TypeScript Express: ایمنی نوع Route Handler

TypeScript به یک سنگ بنای توسعه مدرن JavaScript تبدیل شده است و قابلیت های تایپ استاتیک را ارائه می دهد که کیفیت کد، قابلیت نگهداری و مقیاس پذیری را افزایش می دهد. هنگامی که با Express.js، یک فریم ورک محبوب برنامه های کاربردی وب Node.js، ترکیب شود، TypeScript می تواند به طور قابل توجهی استحکام API های backend شما را بهبود بخشد. این راهنمای جامع به بررسی چگونگی استفاده از TypeScript برای دستیابی به ایمنی نوع route handler در برنامه های Express.js می پردازد، و مثال های عملی و بهترین شیوه ها را برای ساخت API های قوی و قابل نگهداری برای مخاطبان جهانی ارائه می دهد.

چرا ایمنی نوع در Express.js مهم است

در زبان های پویا مانند JavaScript، خطاها اغلب در زمان اجرا catch می شوند، که می تواند منجر به رفتار غیرمنتظره و مسائل دشوار برای اشکال زدایی شود. TypeScript با معرفی تایپ استاتیک این مشکل را حل می کند و به شما امکان می دهد خطاها را در طول توسعه قبل از اینکه به مرحله production برسند، catch کنید. در زمینه Express.js، ایمنی نوع به ویژه برای route handler ها بسیار مهم است، جایی که شما با request و response objects، پارامترهای query و request bodies سر و کار دارید. برخورد نادرست با این عناصر می تواند منجر به crash برنامه، خراب شدن داده ها و آسیب پذیری های امنیتی شود.

• تشخیص زودهنگام خطا: خطاهای مربوط به نوع را در طول توسعه catch کنید و احتمال غافلگیری در زمان اجرا را کاهش دهید.
• بهبود قابلیت نگهداری کد: Type annotations کد را آسان تر برای درک و refactor می کند.
• تکمیل کد و ابزار پیشرفته: IDE ها می توانند پیشنهادات و بررسی خطاهای بهتری را با اطلاعات نوع ارائه دهند.
• کاهش باگ ها: ایمنی نوع به جلوگیری از خطاهای رایج برنامه نویسی، مانند انتقال انواع داده های نادرست به توابع، کمک می کند.

راه اندازی یک پروژه TypeScript Express.js

قبل از ورود به ایمنی نوع route handler، بیایید یک پروژه اساسی TypeScript Express.js راه اندازی کنیم. این به عنوان پایه و اساس مثال های ما عمل خواهد کرد.

پیش نیازها

• Node.js و npm (Node Package Manager) نصب شده باشند. می توانید آنها را از وب سایت رسمی Node.js دانلود کنید. اطمینان حاصل کنید که یک نسخه جدید برای سازگاری بهینه دارید.
• یک ویرایشگر کد مانند Visual Studio Code، که پشتیبانی عالی از TypeScript ارائه می دهد.

مقداردهی اولیه پروژه

1. یک دایرکتوری پروژه جدید ایجاد کنید: mkdir typescript-express-app && cd typescript-express-app
2. یک پروژه npm جدید مقداردهی اولیه کنید: npm init -y
3. TypeScript و Express.js را نصب کنید: npm install typescript express
4. فایل های declaration TypeScript را برای Express.js نصب کنید (مهم برای ایمنی نوع): npm install @types/express @types/node
5. TypeScript را مقداردهی اولیه کنید: npx tsc --init (این یک فایل tsconfig.json ایجاد می کند که کامپایلر TypeScript را پیکربندی می کند.)

پیکربندی TypeScript

فایل tsconfig.json را باز کنید و آن را به طور مناسب پیکربندی کنید. در اینجا یک پیکربندی نمونه آورده شده است:

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

پیکربندی های کلیدی که باید به آنها توجه کنید:

• target: نسخه ECMAScript target را مشخص می کند. es6 یک نقطه شروع خوب است.
• module: نسل کد ماژول را مشخص می کند. commonjs یک انتخاب رایج برای Node.js است.
• outDir: دایرکتوری output را برای فایل های JavaScript کامپایل شده مشخص می کند.
• rootDir: دایرکتوری ریشه فایل های منبع TypeScript خود را مشخص می کند.
• strict: تمام گزینه های strict type-checking را برای ایمنی نوع پیشرفته فعال می کند. این بسیار توصیه می شود.
• esModuleInterop: قابلیت همکاری بین CommonJS و ES Modules را فعال می کند.

ایجاد نقطه ورود

یک دایرکتوری src ایجاد کنید و یک فایل index.ts اضافه کنید:

mkdir src
touch src/index.ts

فایل src/index.ts را با یک تنظیمات سرور اساسی Express.js پر کنید:

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

const app = express();
const port = 3000;

app.get('/', (req: Request, res: Response) => {
  res.send('Hello, TypeScript Express!');
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

اضافه کردن یک اسکریپت build

یک اسکریپت build به فایل package.json خود اضافه کنید تا کد TypeScript را کامپایل کنید:

"scripts": {
  "build": "tsc",
  "start": "node dist/index.js",
  "dev": "npm run build && npm run start"
}

اکنون می توانید npm run dev را اجرا کنید تا سرور را build و start کنید.

ایمنی نوع Route Handler: تعریف انواع Request و Response

هسته اصلی ایمنی نوع route handler در تعریف صحیح انواع برای اشیاء Request و Response نهفته است. Express.js انواع ژنریک را برای این اشیاء ارائه می دهد که به شما امکان می دهد انواع پارامترهای query، request body و route parameters را مشخص کنید.

انواع Route Handler اساسی

بیایید با یک route handler ساده شروع کنیم که انتظار یک نام به عنوان پارامتر query دارد:

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

const app = express();
const port = 3000;

interface NameQuery {
  name: string;
}

app.get('/hello', (req: Request<any, any, any, NameQuery>, res: Response) => {
  const name = req.query.name;

  if (!name) {
    return res.status(400).send('Name parameter is required.');
  }

  res.send(`Hello, ${name}!`);
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

در این مثال:

• Request<any, any, any, NameQuery> نوع request object را تعریف می کند.
• اولین any نشان دهنده route parameters است (مثلاً /users/:id).
• دومین any نشان دهنده نوع response body است.
• سومین any نشان دهنده نوع request body است.
• NameQuery یک interface است که ساختار پارامترهای query را تعریف می کند.

با تعریف interface NameQuery، TypeScript اکنون می تواند تأیید کند که ویژگی req.query.name وجود دارد و از نوع string است. اگر سعی کنید به یک ویژگی غیر موجود دسترسی پیدا کنید یا مقداری از نوع اشتباه اختصاص دهید، TypeScript یک خطا را علامت گذاری می کند.

مدیریت Request Bodies

برای مسیرهایی که request bodies را می پذیرند (مثلاً POST، PUT، PATCH)، می توانید یک interface برای request body تعریف کنید و از آن در نوع Request استفاده کنید:

import express, { Request, Response } from 'express';
import bodyParser from 'body-parser';

const app = express();
const port = 3000;

app.use(bodyParser.json()); // Important for parsing JSON request bodies

interface CreateUserRequest {
  firstName: string;
  lastName: string;
  email: string;
}

app.post('/users', (req: Request<any, any, CreateUserRequest>, res: Response) => {
  const { firstName, lastName, email } = req.body;

  // Validate the request body
  if (!firstName || !lastName || !email) {
    return res.status(400).send('Missing required fields.');
  }

  // Process the user creation (e.g., save to database)
  console.log(`Creating user: ${firstName} ${lastName} (${email})`);

  res.status(201).send('User created successfully.');
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

در این مثال:

• CreateUserRequest ساختار request body مورد انتظار را تعریف می کند.
• app.use(bodyParser.json()) برای parsing JSON request bodies بسیار مهم است. بدون آن، req.body تعریف نشده خواهد بود.
• نوع Request اکنون Request<any, any, CreateUserRequest> است، که نشان می دهد request body باید با interface CreateUserRequest مطابقت داشته باشد.

TypeScript اکنون اطمینان حاصل می کند که object req.body حاوی ویژگی های مورد انتظار (firstName، lastName و email) است و انواع آنها صحیح هستند. این امر خطر خطاهای زمان اجرا ناشی از داده های request body نادرست را به طور قابل توجهی کاهش می دهد.

مدیریت Route Parameters

برای مسیرهایی با پارامترها (مثلاً /users/:id)، می توانید یک interface برای route parameters تعریف کنید و از آن در نوع Request استفاده کنید:

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

const app = express();
const port = 3000;

interface UserParams {
  id: string;
}

interface User {
  id: string;
  firstName: string;
  lastName: string;
  email: string;
}

const users: User[] = [
  { id: '1', firstName: 'John', lastName: 'Doe', email: 'john.doe@example.com' },
  { id: '2', firstName: 'Jane', lastName: 'Smith', email: 'jane.smith@example.com' },
];

app.get('/users/:id', (req: Request<UserParams>, res: Response) => {
  const userId = req.params.id;

  const user = users.find(u => u.id === userId);

  if (!user) {
    return res.status(404).send('User not found.');
  }

  res.json(user);
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

در این مثال:

• UserParams ساختار route parameters را تعریف می کند و مشخص می کند که پارامتر id باید یک string باشد.
• نوع Request اکنون Request<UserParams> است، که نشان می دهد object req.params باید با interface UserParams مطابقت داشته باشد.

TypeScript اکنون اطمینان حاصل می کند که ویژگی req.params.id وجود دارد و از نوع string است. این به جلوگیری از خطاهای ناشی از دسترسی به route parameters غیر موجود یا استفاده از آنها با انواع نادرست کمک می کند.

مشخص کردن انواع Response

در حالی که تمرکز بر ایمنی نوع request بسیار مهم است، تعریف انواع response نیز وضوح کد را افزایش می دهد و به جلوگیری از ناسازگاری ها کمک می کند. می توانید نوع داده ای را که در response ارسال می کنید، تعریف کنید.

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

const app = express();
const port = 3000;

interface User {
  id: string;
  firstName: string;
  lastName: string;
  email: string;
}

const users: User[] = [
  { id: '1', firstName: 'John', lastName: 'Doe', email: 'john.doe@example.com' },
  { id: '2', firstName: 'Jane', lastName: 'Smith', email: 'jane.smith@example.com' },
];

app.get('/users', (req: Request, res: Response<User[]>) => {
    res.json(users);
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

در اینجا، Response<User[]> مشخص می کند که response body باید یک آرایه از object های User باشد. این به اطمینان حاصل می کند که شما به طور مداوم ساختار داده صحیح را در response های API خود ارسال می کنید. اگر سعی کنید داده هایی را ارسال کنید که با نوع User[] مطابقت ندارند، TypeScript یک هشدار صادر می کند.

ایمنی نوع Middleware

Middleware functions برای مدیریت نگرانی های متقابل در برنامه های Express.js ضروری هستند. اطمینان از ایمنی نوع در middleware به اندازه route handler ها مهم است.

Typing Middleware Functions

ساختار اساسی یک middleware function در TypeScript مشابه route handler است:

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

function authenticationMiddleware(req: Request, res: Response, next: NextFunction) {
  // Authentication logic
  const isAuthenticated = true; // Replace with actual authentication check

  if (isAuthenticated) {
    next(); // Proceed to the next middleware or route handler
  } else {
    res.status(401).send('Unauthorized');
  }
}

const app = express();
const port = 3000;

app.use(authenticationMiddleware);

app.get('/', (req: Request, res: Response) => {
  res.send('Hello, authenticated user!');
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

در این مثال:

• NextFunction یک نوع ارائه شده توسط Express.js است که نشان دهنده middleware function بعدی در زنجیره است.
• middleware function همان object های Request و Response را به عنوان route handler ها می گیرد.

Augmenting the Request Object

گاهی اوقات، ممکن است بخواهید ویژگی های سفارشی را به object Request در middleware خود اضافه کنید. به عنوان مثال، یک authentication middleware ممکن است یک ویژگی user به object request اضافه کند. برای انجام این کار به روشی type-safe، باید interface Request را augment کنید.

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

interface User {
  id: string;
  username: string;
  email: string;
}

// Augment the Request interface
declare global {
  namespace Express {
    interface Request {
      user?: User;
    }
  }
}

function authenticationMiddleware(req: Request, res: Response, next: NextFunction) {
  // Authentication logic (replace with actual authentication check)
  const user: User = { id: '123', username: 'johndoe', email: 'john.doe@example.com' };
  req.user = user; // Add the user to the request object
  next(); // Proceed to the next middleware or route handler
}

const app = express();
const port = 3000;

app.use(authenticationMiddleware);

app.get('/', (req: Request, res: Response) => {
  const username = req.user?.username || 'Guest';
  res.send(`Hello, ${username}!`);
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

در این مثال:

• ما از یک global declaration برای augment کردن interface Express.Request استفاده می کنیم.
• ما یک ویژگی user اختیاری از نوع User به interface Request اضافه می کنیم.
• اکنون، می توانید به ویژگی req.user در route handler های خود بدون شکایت TypeScript دسترسی پیدا کنید. علامت سوال ? در req.user?.username برای مدیریت مواردی که کاربر احراز هویت نشده است بسیار مهم است و از خطاهای احتمالی جلوگیری می کند.

بهترین شیوه ها برای یکپارچه سازی TypeScript Express

برای به حداکثر رساندن مزایای TypeScript در برنامه های Express.js خود، از این بهترین شیوه ها پیروی کنید:

• فعال کردن Strict Mode: از گزینه "strict": true در فایل tsconfig.json خود برای فعال کردن تمام گزینه های strict type-checking استفاده کنید. این به catch زودهنگام خطاهای احتمالی کمک می کند و سطح بالاتری از ایمنی نوع را تضمین می کند.
• استفاده از Interfaces و Type Aliases: Interfaces و type aliases را برای نشان دادن ساختار داده های خود تعریف کنید. این کار کد شما را خواناتر و قابل نگهداری تر می کند.
• استفاده از Generic Types: از generic types برای ایجاد اجزای قابل استفاده مجدد و type-safe استفاده کنید.
• نوشتن Unit Tests: Unit tests بنویسید تا صحت کد خود را تأیید کنید و اطمینان حاصل کنید که type annotations شما دقیق هستند. تست برای حفظ کیفیت کد بسیار مهم است.
• استفاده از Linter و Formatter: از یک linter (مانند ESLint) و یک formatter (مانند Prettier) برای اعمال سبک های کدنویسی consistent و catch خطاهای احتمالی استفاده کنید.
• اجتناب از نوع any: استفاده از نوع any را به حداقل برسانید، زیرا type checking را دور می زند و هدف استفاده از TypeScript را از بین می برد. فقط در صورت لزوم از آن استفاده کنید و در صورت امکان از انواع یا generics خاص تری استفاده کنید.
• ساختار منطقی پروژه خود: پروژه خود را بر اساس عملکرد به ماژول ها یا پوشه ها سازماندهی کنید. این امر قابلیت نگهداری و مقیاس پذیری برنامه شما را بهبود می بخشد.
• استفاده از Dependency Injection: استفاده از یک dependency injection container را برای مدیریت وابستگی های برنامه خود در نظر بگیرید. این می تواند کد شما را قابل آزمایش تر و قابل نگهداری تر کند. کتابخانه هایی مانند InversifyJS انتخاب های محبوبی هستند.

مفاهیم پیشرفته TypeScript برای Express.js

استفاده از Decorators

Decorators یک روش مختصر و رسا برای اضافه کردن فراداده به کلاس ها و توابع ارائه می دهند. می توانید از decorators برای ساده سازی ثبت مسیر در Express.js استفاده کنید.

ابتدا باید experimental decorators را در فایل tsconfig.json خود با افزودن "experimentalDecorators": true به compilerOptions فعال کنید.

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "experimentalDecorators": true
  }
}

سپس، می توانید یک decorator سفارشی برای ثبت مسیرها ایجاد کنید:

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

function route(method: string, path: string) {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    if (!target.__router__) {
      target.__router__ = Router();
    }

    target.__router__[method](path, descriptor.value);
  };
}

class UserController {
  @route('get', '/users')
  getUsers(req: Request, res: Response) {
    res.send('List of users');
  }

  @route('post', '/users')
  createUser(req: Request, res: Response) {
    res.status(201).send('User created');
  }

  public getRouter() {
    return this.__router__;
  }
}

const userController = new UserController();

const app = express();
const port = 3000;

app.use('/', userController.getRouter());

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

در این مثال:

• decorator route متد HTTP و مسیر را به عنوان آرگومان می گیرد.
• این متد decorated را به عنوان یک route handler در router مرتبط با کلاس ثبت می کند.
• این کار ثبت مسیر را ساده می کند و کد شما را خواناتر می کند.

استفاده از Custom Type Guards

Type guards توابعی هستند که نوع یک متغیر را در یک محدوده خاص محدود می کنند. می توانید از custom type guards برای اعتبارسنجی request bodies یا query parameters استفاده کنید.

interface Product {
    id: string;
    name: string;
    price: number;
}

function isProduct(obj: any): obj is Product {
    return typeof obj === 'object' &&
           obj !== null &&
           typeof obj.id === 'string' &&
           typeof obj.name === 'string' &&
           typeof obj.price === 'number';
}

import express, { Request, Response } from 'express';
import bodyParser from 'body-parser';

const app = express();
const port = 3000;

app.use(bodyParser.json());

app.post('/products', (req: Request, res: Response) => {
    if (!isProduct(req.body)) {
        return res.status(400).send('Invalid product data');
    }

    const product: Product = req.body;
    console.log(`Creating product: ${product.name}`);
    res.status(201).send('Product created');
});

app.listen(port, () => {
    console.log(`Server running at http://localhost:${port}`);
});

در این مثال:

• تابع isProduct یک custom type guard است که بررسی می کند آیا یک object با interface Product مطابقت دارد یا خیر.
• در داخل route handler /products، تابع isProduct برای اعتبارسنجی request body استفاده می شود.
• اگر request body یک محصول معتبر باشد، TypeScript می داند که req.body از نوع Product در داخل بلوک if است.

توجه به ملاحظات جهانی در طراحی API

هنگام طراحی API ها برای مخاطبان جهانی، چندین عامل باید در نظر گرفته شوند تا از دسترسی، قابلیت استفاده و حساسیت فرهنگی اطمینان حاصل شود.

• محلی سازی و بین المللی سازی (i18n و L10n):
  • Content Negotiation: از چندین زبان و منطقه از طریق content negotiation بر اساس هدر Accept-Language پشتیبانی کنید.
  • قالب بندی تاریخ و زمان: از فرمت ISO 8601 برای نمایش تاریخ و زمان برای جلوگیری از ابهام در مناطق مختلف استفاده کنید.
  • قالب بندی اعداد: قالب بندی اعداد را مطابق با locale کاربر مدیریت کنید (به عنوان مثال، جداکننده های اعشاری و جداکننده های هزار).
  • مدیریت ارز: از چندین ارز پشتیبانی کنید و در صورت لزوم اطلاعات نرخ ارز را ارائه دهید.
  • جهت متن: زبان های راست به چپ (RTL) مانند عربی و عبری را در خود جای دهید.
• مناطق زمانی:
  • تاریخ ها و زمان ها را در UTC (زمان هماهنگ جهانی) در سمت سرور ذخیره کنید.
  • به کاربران اجازه دهید منطقه زمانی دلخواه خود را مشخص کنند و تاریخ ها و زمان ها را بر این اساس در سمت کلاینت تبدیل کنند.
  • از کتابخانه هایی مانند moment-timezone برای مدیریت تبدیل منطقه زمانی استفاده کنید.
• رمزگذاری کاراکتر:
  • از رمزگذاری UTF-8 برای تمام داده های متنی برای پشتیبانی از طیف گسترده ای از کاراکترها از زبان های مختلف استفاده کنید.
  • اطمینان حاصل کنید که پایگاه داده و سایر سیستم های ذخیره سازی داده شما برای استفاده از UTF-8 پیکربندی شده اند.
• دسترسی:
  • از دستورالعمل های دسترسی (به عنوان مثال، WCAG) پیروی کنید تا API خود را برای کاربران دارای معلولیت در دسترس قرار دهید.
  • پیام های خطای واضح و توصیفی ارائه دهید که به راحتی قابل درک باشند.
  • از عناصر HTML معنایی و ویژگی های ARIA در مستندات API خود استفاده کنید.
• حساسیت فرهنگی:
  • از استفاده از ارجاعات، اصطلاحات یا شوخی های خاص فرهنگی که ممکن است برای همه کاربران قابل درک نباشند، خودداری کنید.
  • مراقب تفاوت های فرهنگی در سبک های ارتباطی و ترجیحات باشید.
  • تاثیر بالقوه API خود را بر گروه های فرهنگی مختلف در نظر بگیرید و از تداوم کلیشه ها یا تعصبات خودداری کنید.
• حریم خصوصی و امنیت داده ها:
  • از مقررات حریم خصوصی داده ها مانند GDPR (مقررات عمومی حفاظت از داده ها) و CCPA (قانون حفظ حریم خصوصی مصرف کننده کالیفرنیا) پیروی کنید.
  • مکانیسم های احراز هویت و مجوز قوی را برای محافظت از داده های کاربر پیاده سازی کنید.
  • داده های حساس را هم در حین انتقال و هم در حالت استراحت رمزگذاری کنید.
  • به کاربران کنترل بر داده های خود را بدهید و به آنها اجازه دهید به داده های خود دسترسی داشته باشند، آنها را اصلاح کنند و حذف کنند.
• مستندات API:
  • مستندات API جامع و سازمان یافته ارائه دهید که به راحتی قابل درک و پیمایش باشد.
  • از ابزارهایی مانند Swagger/OpenAPI برای تولید مستندات API تعاملی استفاده کنید.
  • مثال های کد را در چندین زبان برنامه نویسی برای پاسخگویی به مخاطبان متنوع قرار دهید.
  • مستندات API خود را به چندین زبان ترجمه کنید تا به مخاطبان بیشتری دسترسی پیدا کنید.
• مدیریت خطا:
  • پیام های خطای خاص و آموزنده ارائه دهید. از پیام های خطای عمومی مانند "مشکلی پیش آمد" خودداری کنید.
  • از کدهای وضعیت HTTP استاندارد برای نشان دادن نوع خطا استفاده کنید (به عنوان مثال، 400 برای درخواست نامعتبر، 401 برای غیرمجاز، 500 برای خطای سرور داخلی).
  • کدهای خطا یا شناسه هایی را درج کنید که می توانند برای ردیابی و اشکال زدایی مسائل استفاده شوند.
  • برای اشکال زدایی و نظارت، خطاها را در سمت سرور ثبت کنید.
• محدود کردن نرخ: محدود کردن نرخ را برای محافظت از API خود در برابر سوء استفاده و اطمینان از استفاده منصفانه پیاده سازی کنید.
• نسخه بندی: از نسخه بندی API استفاده کنید تا امکان تغییرات سازگار با نسخه قبلی را فراهم کنید و از شکستن کلاینت های موجود جلوگیری کنید.

نتیجه

یکپارچه سازی TypeScript Express به طور قابل توجهی قابلیت اطمینان و قابلیت نگهداری API های backend شما را بهبود می بخشد. با استفاده از ایمنی نوع در route handler ها و middleware، می توانید خطاها را در مراحل اولیه فرآیند توسعه catch کنید و برنامه های کاربردی قوی تر و مقیاس پذیرتر را برای مخاطبان جهانی بسازید. با تعریف انواع request و response، اطمینان حاصل می کنید که API شما به یک ساختار داده consistent پایبند است و احتمال خطاهای زمان اجرا را کاهش می دهد. به یاد داشته باشید که برای به حداکثر رساندن مزایای TypeScript، به بهترین شیوه ها مانند فعال کردن strict mode، استفاده از interfaces و type aliases و نوشتن unit tests پایبند باشید. همیشه عوامل جهانی مانند محلی سازی، مناطق زمانی و حساسیت فرهنگی را در نظر بگیرید تا اطمینان حاصل کنید که API های شما در سراسر جهان قابل دسترسی و استفاده هستند.