تخطي إلى المحتوى
POST AI agent ready /v1/short-url/create

URL Shortener API - إنشاء روابط قصيرة باستخدام تتبع النقرات

أرسل عنوان URL واحصل على رابط مختصر مع ارتباط ثابت تم إنشاؤه تلقائيًا أو مخصص. يتم إعادة توجيه الروابط القصيرة عبر 302 وتتبع عدد النقرات. البزاقات المخصصة تدعم الحروف والأرقام والواصلات والشرطات السفلية. إذا تم أخذ الارتباط الثابت بالفعل، فسترجع واجهة برمجة التطبيقات (API) خطأً حتى تتمكن من إعادة المحاولة باستخدام خطأ مختلف.

Parameters

stringrequired

The target URL to shorten. Must be a valid http or https URL.

string

An optional custom slug for the short URL. Letters, numbers, hyphens, and underscores only.

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

إنشاء روابط قصيرة يمكن تتبعها للحملات التسويقية

أنشئ رابطًا قصيرًا مخصصًا لكل حملة (على سبيل المثال، /launch-2026). استخدم نقطة نهاية الإحصائيات لتتبع النقرات وقياس التفاعل بدون أدوات تحليل خارجية.

أنشئ ميزة اختصار الروابط في منتج SaaS الخاص بك

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

Frequently asked questions

هل تنتهي صلاحية الروابط القصيرة؟
الروابط القصيرة التي تم إنشاؤها من خلال واجهة برمجة التطبيقات (API) لا تحتوي على تاريخ انتهاء صلاحية مضمن. وتستمر في التخزين حتى تتم إزالتها يدويًا أو مسح وحدة التخزين الأساسية.
ماذا يحدث إذا تم أخذ البزاقة المخصصة الخاصة بي بالفعل؟
ترجع واجهة برمجة التطبيقات خطأ SLUG_TAKEN. يمكنك إعادة المحاولة باستخدام رمز ثابت مختلف أو حذف الحقل custom_slug للحصول على رمز ثابت مكون من 6 أحرف يتم إنشاؤه تلقائيًا.
ما هي الشخصيات المسموح بها في البزاقات المخصصة؟
الحروف (A-Z، a-z)، والأرقام (0-9)، والواصلات (-)، والشرطات السفلية (_). تتسبب أي أحرف أخرى في حدوث خطأ INVALID_SLUG.
هل يتم تتبع عدد النقرات تلقائيًا؟
نعم. في كل مرة يزور فيها شخص ما عنوان URL القصير، يزداد عداد النقرات. استخدم نقطة النهاية GET /v1/short-url/{slug}/stats لاسترداد العدد الحالي.
ما نوع إعادة التوجيه الذي يستخدمه عنوان URL القصير؟
يعرض عنوان URL القصير عملية إعادة توجيه 302 (مؤقتة). وهذا يعني أن محركات البحث لن تنقل حقوق الارتباط إلى عنوان URL المستهدف، ويمكنك تغيير الوجهة لاحقًا إذا لزم الأمر.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs