واجهة برمجة تطبيقات تقصير الروابط من Linkly

قم بإنشاء وتحديث وإدارة الروابط برمجياً باستخدام واجهة برمجة تطبيقات تقصير الروابط من Linkly.

ذات صلة: واجهة برمجة التطبيقات للتحليلات | Webhooks

قبل البدء

يقوم Linkly بإنشاء طلبات API في الواجهة لتنسخها والصقها في تطبيقاتك.

يعمل هذا لإنشاء الرابط وتحديث الرابط.

وفر الوقت واترك لنا العمل الشاق:

1. 1
   اطلع على ما يلي للحصول على طلبات إنشاء الرابط API.
2. 2
   انسخ الطلبات بالكامل. يمكنك التحقق من أنها تعمل لديك.
3. 3
   اطلب من ChatGPT أو ما يعادله أن يكيف هذه الطلبات مع كود المصدر لتطبيقك. لا توجد حاجة لقضاء الوقت في القيام بتكامل معقد. واجهة برمجة التطبيقات الخاصة بنا قابلة للاستهلاك بالكامل من قبل الآلة.

---

مواصفات OpenAPI 3.0

يمكنك إنشاء طلبات API مباشرة من واجهة مستخدم Linkly.

تم توثيق واجهة برمجة التطبيقات من Linkly باستخدام معيار OpenAPI، والذي يتجاوز ما هو مقدم أدناه. نفس نقاط النهاية متاحة أيضاً كمجموعة Postman بنقرة واحدة.

عرض مواصفات OpenAPI

تشغيل في Postman

المصادقة

ستحتاج إلى:

• مفتاح API الخاص بك
• معرّف مساحة العمل

يمكنك الحصول على هذه التفاصيل من داخل Linkly.

1. 1
   سجل الدخول إلى Linkly.
2. 2
   انقر على الإعدادات.
3. 3
   انقر على مفاتيح API.

إنشاء أو تحديث رابط

لإنشاء رابط، كل ما تحتاج إلى فعله هو إرسال طلب POST إلى:

https://app.linklyhq.com/api/v1/link

مع الحقول التالية في الهيئة.

نوع الترميز هو x-www-form-urlencoded أو application/json.

إذا كنت تقدم حقل القواعد، يجب عليك استخدام application/json.

نوصيك باستخدام JSON مع مواصفات Open API.

مثال على الطلب باستخدام curl

يوضح الرمز أدناه كيفية إرسال طلب API لإنشاء رابط.

curl -X POST https://app.linklyhq.com/api/v1/link
-H 'cache-control: no-cache'
-d 'api_key=your_secret_key&workspace_id=1&url=http%3A%2F%2Fwww.wikijob.co.uk&name=Test%20Link'

سيعيد الرد الناجح كائن JSON يمثل الرابط، جنباً إلى جنب مع معرّف الرابط.

{
    "id": 9512,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "replacements": null,
    "enabled": true,
    "cloaking": false,
    "forward_params": false,
    "hide_referrer": false,
    "block_bots": false,
    "skip_social_crawler_tracking": false,
    "public_analytics": false,
    "password": null,
    "domain": null,
    "slug": null,
    "utm_source": null,
    "utm_medium": null,
    "utm_campaign": null,
    "utm_term": null,
    "utm_content": null,
    "og_title": null,
    "og_description": null,
    "og_image": null,
    "fb_pixel_id": null,
    "tiktok_pixel_id": null,
    "ga4_tag_id": null,
    "gtm_id": null,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "rules": [],
    "expiry_datetime": null,
    "expiry_destination": null,
    "expiry_clicks": null,
    "qr_styles": null,
    "webhooks": [],
    "notify_user_ids": [],
    "workspace_id": 1448,
    "deleted": false
}

تحديث رابط

لتحديث رابط، أرسل نفس الطلب الذي ستستخدمه لإنشاء الرابط، لكن قم بتضمين الحقل id للرابط الذي تريد تحديثه، بالإضافة إلى التغييرات.

إنشاء الدورّات عبر API

لإنشاء دورّ، قدّم حقلاً يسمى rules كمصفوفة JSON، جنباً إلى جنب مع حمل الرابط أعلاه. يجب عليك استخدام application/json لإرسال مصفوفات JSON.

على سبيل المثال:

[
  {"what": "rotator", "url": "https://www.microsoft.com", "percentage": "50"},
  {"what": "rotator", "url": "https://www.apple.com", "percentage": "50"}
]

إنشاء إعادات التوجيه الجغرافية عبر API

لإعادة التوجيه حسب البلد، قدّم حقلاً يسمى rules كمصفوفة JSON، جنباً إلى جنب مع حمل الرابط أعلاه. يجب عليك استخدام ترميز application/json لإرسال مصفوفات JSON.

على سبيل المثال:

[
  {"what": "country", "url": "https://www.microsoft.com", "matches": "UK"},
  {"what": "country", "url": "https://www.apple.com", "matches": "US"}
]

البلد هو رمز البلد الثنائي الأحرف ISO 3166.

إنشاء إعادات التوجيه حسب الجهاز عبر API

لإعادة التوجيه حسب الجهاز، قدّم حقلاً يسمى rules كمصفوفة JSON، جنباً إلى جنب مع حمل الرابط أعلاه.

على سبيل المثال:

[
  {"what": "platform", "url": "https://www.google.com", "matches": "windows"},
  {"what": "platform", "url": "https://www.apple.com", "matches": "ios"}
]

حيث يكون الحقل matches أحد الخيارات التالية:

• ios
• android
• windows
• linux
• mac

إنشاء أو تحديث عدة روابط في طلب واحد

يدعم Linkly إنشاء/تعديل ما يصل إلى 1000 رابط لكل طلب.

للقيام بذلك، قدّم مفتاح API الخاص بك كجزء من الطلب كما يلي:

https://app.linklyhq.com/api/v1/links?api_key=XXXXXXXXXXX

ثم استخدم نفس المخطط الموضح أعلاه لحالات الرابط الفردية، لكن قم بتغليف طلبات الرابط في مصفوفة، بالشكل التالي:

[{link}, {link}]

إليك طلب كامل سيحدث رابطين:

wget --no-check-certificate \
  --method POST \
  --timeout=0 \
  --header 'Content-Type: application/json' \
  --body-data '[
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://nature.com",
        "name": "Test",
        "id": LINK_ID
    },
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://science.com",
        "id": LINK_ID
    }
]' \
   'https://app.linklyhq.com/api/v1/links?api_key=API_KEY'

يعمل هذا لإجراءات الإنشاء والتحديث.

يرجى ملاحظة أنه قد يستغرق ما يصل إلى 60 ثانية لطلب كبير. إذا استغرقت الطلبات وقتاً أطول من ذلك، فسوف تفشل، ويجب عليك التفكير في تقسيم حملك العملية إلى أجزاء أصغر.

حدود المعدل

تقتصر واجهة برمجة تطبيقات تقصير الروابط على 20 طلباً/ثانية. ما يصل إلى 200/طلب في الثانية متاح عند الطلب. يمكنك تحميل ما يصل إلى 1000 رابط في طلب واحد.

ذات صلة

• واجهة برمجة التطبيقات للتحليلات - تصدير بيانات النقرات وتقارير المرور
• Webhooks - إخطارات النقرات في الوقت الفعلي
• تكامل Zapier - التكاملات بدون كود