API الروابط المختصرة - التوثيق

واجهة JSON لإنشاء روابط مختصرة والاستعلام عنها. استخدم مفتاح API الصادر لحسابك (أو API_TOKEN للمنصة عند الحاجة).

واجهة API العامة: https://anyurl.bond - مسارات JSON تحت /api/v1/.

Authorization

Authorization: Bearer YOUR_API_KEY

أرسل مفتاح API بالضبط في Authorization: Bearer. لوحة التحكم تستخدم افتراضيًا مفتاح API فقط؛ صفحة البريد لإدخال كلمة المرور.

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}

{"long_url":"https://example.com","permanent":true}

تنطبق expiration_time و max_uses الاختيارية على الخطة المدفوعة. بدون دفعة، هناك حد شهري تقويمي (UTC، يُعاد في اليوم 1) وتنتهي كل روابط جديدة بعد نحو 10 دقائق بغض النظر عن الجسم.

GET /api/v1/info/{short_code}

يعيد بيانات الوصف والصحة لرمز قصير دون زيادة عدد النقرات.

GET /api/v1/me

يعيد خطتك والحدود الفعلية من اللوحة واستخدام الشهر (UTC): روابط جديدة وتعديلات عبر API.

GET /api/v1/links

?limit=50&offset=0

يعرض روابطك القصيرة التي أُنشئت بمفتاح API فقط (owner_id يطابق ذلك المفتاح؛ نفس نطاق GET /info). لا يمكن لرمز API للمنصة استخدام هذه النقطة. استعلام اختياري: limit (افتراضي 50، بحد أقصى 100)، offset (افتراضي 0، بحد أقصى 100000). JSON: links (نفس حقول GET /info لكل عنصر)، total، limit، offset. القائمة لا تحذف صفوفًا ولا تزيد النقرات.

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

لتغيير رمز قصير موجود استخدم PUT أو PATCH على /api/v1/info/{short_code} - وليس POST /shorten. الجسم (JSON): أي من long_url و expiration_time و max_uses و allow_bots. احذف الحقل لتركه كما هو. امسح الانتهاء الزمني بـ expiration_time ""; استعمال غير محدود بـ max_uses -1. شكل الاستجابة مثل GET /info.

أمثلة سطر الأوامر (curl)

YOUR_API_KEY مجرد عنصر نائب. استخدم مفتاح API الحقيقي. الأمثلة تستخدم https://anyurl.bond.

POST /api/v1/shorten - JSON كامل (المضيف https://anyurl.bond)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"

POST /api/v1/shorten - جسم أدنى (مدفوع: انتهاء افتراضي 24 ساعة)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

POST /api/v1/shorten - دائم (مدفوع؛ يستهلك تعديلًا ذكيًا)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"

GET /api/v1/info/{short_code} - مثال للرمز القصير abc123

curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET /api/v1/me

curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET /api/v1/links - ترقيم روابطك القصيرة

curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer YOUR_API_KEY'

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"

PUT /api/v1/info/{short_code}

curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"

Verbose (-v) للتصحيح

curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

المستوى المجاني من API: حتى 100 رابط قصير جديد لكل شهر تقويمي (UTC)، وتُصفَّر الحصة في اليوم الأول من الشهر. كل رابط ينتهي بعد نحو 10 دقائق. الخطط المدفوعة تتبع نفس الدورة الشهرية.

الصفحة الرئيسية · الشروط والأحكام