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

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

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

Authorization

Authorization: Bearer 1234

أرسل مفتاح API كما هو في Authorization: Bearer. تسجيل الدخول للوحة يستخدم نفس المفتاح مع بريدك.

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)

الرمز 1234 للتوضيح فقط - استخدم مفتاح 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 1234' \
  -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 1234' \
  -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 1234' \
  -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 1234'

GET /api/v1/me

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

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

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

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -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 1234' \
  -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 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

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

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