پرش به مطلب اصلی

میان‌افزار کوتاه‌سازی لینک (ShortenUrl)

میان‌افزار URL کوتاه شده مسئول مدیریت و ریدایرکت URLهای کوتاه شده است.

هدف​

این میان‌افزار URLهای کوتاه شده را دریافت کرده و کاربر را به URL اصلی ریدایرکت می‌کند.

نحوه کار​

  1. بررسی تطابق URL با مسیر کوتاه شده
  2. جستجو توکن در پایگاه داده
  3. بررسی اعتبار و انقضا
  4. ریدایرکت به URL اصلی
  5. بروزرسانی آمار استفاده

تنظیمات​

// تنظیمات URL کوتاه شده
SHORTEN_URL_INFO: {
  baseUrl: "/s", // پیشوند URL کوتاه شده
}

ساختار URL​

/s/{token}

مثال:

/s/abc123  -> ریدایرکت به URL اصلی

ویژگی‌ها​

  • ردیابی استفاده: شمارش تعداد استفاده از هر URL
  • بررسی اعتبار: اطمینان از وجود و معتبر بودن توکن
  • بروزرسانی خودکار: بروزرسانی زمان آخرین استفاده
  • لاگ‌گیری: ثبت اطلاعات ریدایرکت

مدل داده​

interface CoreShortenUrl {
  token: string;
  original_url: string;
  settings: {
    used_count: number;
    expires_at?: number;
    // ... سایر تنظیمات
  };
}

خطاها​

  • 404 Invalid or expired this shorten url: توکن نامعتبر یا منقضی

مثال استفاده​

// ایجاد URL کوتاه شده
const shortenUrl = await CoreShortenUrl.create({
  token: "abc123",
  original_url: "https://example.com/very/long/url",
  settings: { used_count: 0 }
});

// دسترسی به URL کوتاه شده
GET /s/abc123
// -> ریدایرکت به https://example.com/very/long/url

امنیت​

  • توکن‌های منحصر به فرد و تصادفی
  • امکان تنظیم تاریخ انقضا
  • ردیابی استفاده برای جلوگیری از سوءاستفاده