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

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

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

قبل أن تبدأ

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

وفر الوقت واترك لنا القيام بالعمل الشاق. واجهة برمجة تطبيقاتنا قابلة للاستهلاك بالكامل من قبل الآلات.

التفويض

ستحتاج إلى مفتاح واجهة برمجة التطبيقات ومعرف مساحة العمل. يمكنك الحصول على هذه التفاصيل من داخل Linkly.

واجهة برمجة تطبيقات تقارير حركة المرور

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

تقوم تقارير حركة المرور من Linkly تلقائياً بإنشاء طلبات واجهة برمجة التطبيقات لك، بناءً على البيانات المعروضة على الشاشة.

تتضمن هذه الروابط مفتاح واجهة برمجة التطبيقات الخاص بك، وسهلة التخصيص والاستخدام في تطبيقاتك الخاصة.

تنسيقات الإخراج

تدعم واجهة برمجة تطبيقات التحليلات ثلاثة تنسيقات إخراج:

وضع المحور (تنسيق المصفوفة)

بشكل افتراضي، تعيد واجهة برمجة التطبيقات البيانات الزمنية برصف واحد لكل تاريخ. مع وضع المحور، يمكنك الحصول على حركة مرور جميع روابطك في طلب واحد كمصفوفة.

استخدم القائمة المنسدلة تصدير البيانات في أي تقرير حركة مرور لتصدير البيانات بسرعة حسب الرابط، أو أضف pivot=link_id إلى طلب واجهة برمجة التطبيقات الخاص بك.

أضف pivot=link_id إلى طلبك للحصول على بيانات تتضمن:

• التواريخ كصفوف (صف واحد لكل يوم)
• الروابط كأعمدة (عمود واحد لكل رابط)

مثال على إخراج المحور CSV/TSV

مثال على إخراج المحور JSON

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

يعتبر وضع المحور مفيداً لـ:

• مقارنة حركة المرور عبر روابط متعددة
• الاستيراد إلى جداول البيانات للتحليل
• بناء لوحات معلومات بكل بيانات الروابط في استدعاء واحد

بيانات النقرات الأولية

بيانات النقرات الأولية التي نسجلها، بما في ذلك المعاملات الكاملة وختم الوقت ومعلومات الموقع الجغرافي، متاحة.

للوصول إلى هذه البيانات، انقر فوق تصدير من علامات التبويب في الأسفل واختر تنسيقك. هذه طلبات واجهة برمجة تطبيقات مكتملة بالكامل يمكنك استخدامها مباشرة في تطبيقك.

ملاحظات بشأن تصدير البيانات

• ضع في الاعتبار تصفية البيانات في العرض أولاً لتقليل كمية البيانات المُصدَّرة. تقوم هذه الوظيفة بتصدير البيانات الأساسية المستخدمة لإنشاء التقرير الحالي على الشاشة.
• يتم حفظ هذه البيانات مؤقتاً لمدة تصل إلى 3 ساعات. الطلبات المتكررة إلى هذا الطرف النهائي لن تنتج بيانات في الوقت الفعلي.

العدد المجموع

يعيد الطرف النهائي /counters/{dimension} إجمالي النقرات المجمعة حسب بُعد واحد — مثل country أو platform أو destination أو referer أو isp أو link_id. تأتي النتائج مرتبة حسب عدد النقرات، من الأعلى أولاً.

يتم إرجاع الحد الأقصى 10000 قيمة. الأبعاد عالية الأصل — destination و referer و remote_ip و isp — يمكن أن يكون لها عدد أكبر بكثير من القيم المميزة على مساحة عمل مشغولة. عندما يحدث ذلك، تتلقى الأفضل 10000 حسب عدد النقرات والباقي لا يتم إرجاعه.

حقل total هو دائماً إجمالي النقرات في كل مجموعة، بما في ذلك أي لم يتم إرجاعه. إذاً في النتيجة المختصرة ستجمع قيم count إلى أقل من total — مما يعني أن النسبة المحسوبة كـ count / total لا تزال دقيقة.

إذا كنت بحاجة إلى مجموعة القيم الكاملة بدلاً من أفضل 10000، قم بتصدير بيانات النقرات الأولية والقيام بتجميعها بنفسك، أو استخدم تكامل BigQuery.

إخطارات النقرات في الوقت الفعلي

للحصول على إخطارات النقرات في الوقت الفعلي، انظر Webhooks. يرسل Webhooks طلب POST إلى عناوين URL المحددة لديك على الفور عند حدوث نقرة، مع معلومات مفصلة حول النقرة.

يمكنك أيضاً إدارة webhooks عبر واجهة برمجة التطبيقات - انظر مواصفات OpenAPI للتفاصيل.

سياسة الاستخدام العادل

حدود المعدل

تقتصر واجهة برمجة تطبيقات التحليلات على 50 طلب في الساعة لكل مساحة عمل.

حدود الاستخدام

بالإضافة إلى حدود المعدل، لدى واجهة برمجة تطبيقات التحليلات حدود استخدام تُعاد تعيينها في كل فترة فواتير:

ما يُعتبر استخداماً

• طلبات واجهة برمجة التطبيقات: كل استدعاء إلى نقاط نهاية واجهة برمجة تطبيقات التحليلات (/clicks و /counters و /export) يُعتبر طلب واحد. تصديرات الروابط (/links/export) التي تتم باستخدام مفتاح واجهة برمجة التطبيقات تُعتبر أيضاً طلب واحد.
• البيانات الممسحة: كمية البيانات التي تعالجها قاعدة البيانات الخاصة بنا للتحليل لتلبية طلبك. نطاقات التواريخ الأوسع والاستعلامات الأكثر تعقيداً تمسح بيانات أكثر.

ما يحدث عند تجاوز الحدود

عندما تستخدم مساحة عمل على خطة مدفوعة جميع طلبات واجهة برمجة التطبيقات الخاصة بها، نضيف تلقائياً حزمة واجهة برمجة تطبيقات إلى اشتراكك حتى تستمر التكاملات الخاصة بك في العمل، وننسل إلى أعضاء مساحة العمل لإعلامهم. تضيف حزمة واجهة برمجة التطبيقات طلبات واجهة برمجة تطبيقات إضافية كل فترة فواتير حتى تزيلها.

تعيد طلبات واجهة برمجة التطبيقات خطأ 429 Too Many Requests بدلاً من ذلك عندما:

1. 1
   مساحة العمل على خطة مجانية أو Starter، والتي لا يمكنها إضافة حزم واجهة برمجة تطبيقات
2. 2
   تم تعيين اشتراك مساحة العمل للإلغاء، أو السداد متأخر
3. 3
   استخدمت مساحة العمل كل حد البيانات الممسحة — حزم واجهة برمجة التطبيقات تضيف الطلبات وليس البيانات

تُعاد تعيين حدود الاستخدام في بداية كل فترة فواتير، وتستمر روابطك في العمل وتتبع النقرات بشكل طبيعي على أي حال.

نصائح لتقليل الاستخدام

يمكن لمعظم المستخدمين الحصول على كل بيانتهم في طلب واجهة برمجة تطبيقات واحد باستخدام وضع المحور (pivot=link_id)، الذي يعيد حركة مرور جميع الروابط كمصفوفة في استدعاء واحد.

• استخدم وضع المحور: أضف pivot=link_id للحصول على حركة مرور جميع الروابط في طلب واحد بدلاً من الاستعلام عن كل رابط على حدة
• احفظ الاستجابات مؤقتاً: قم بتخزين استجابات واجهة برمجة التطبيقات محلياً بدلاً من جلب نفس البيانات بشكل متكرر
• استخدم نطاقات تاريخ أصغر: استعلم فقط عن التواريخ التي تحتاجها
• دفعة الطلبات: اجمع استعلامات روابط متعددة في طلب واحد باستخدام معامل link_ids

هل تحتاج إلى المزيد؟

يمكنك إضافة حزم واجهة برمجة تطبيقات بنفسك في أي وقت تحت Add-ons على صفحة الفوترة. تضيف كل حزمة طلبات واجهة برمجة تطبيقات إضافية كل فترة فواتير؛ تعرض الصفحة السعر لخطتك قبل التأكيد.

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

تكامل BigQuery

بالنسبة لاحتياجات التحليلات عالية الحجم، يقدم Linkly تكامل BigQuery يوفر وصول SQL مباشر إلى بيانات النقرات الخاصة بك.

• وصول البيانات الحية - استعلم عن بيانات النقرات الخاصة بك مباشرة في BigQuery مع التحديثات في الوقت الفعلي
• استعلامات غير محدودة - بدون حدود معدل واجهة برمجة التطبيقات؛ تدفع فقط مقابل حساب BigQuery
• التقارير المخصصة - بناء لوحات معلومات مع Looker أو Data Studio أو Tableau
• توحيد البيانات - انضم إلى بيانات النقرات مع مقاييس الأعمال الأخرى

يتم تضمين تكامل BigQuery في خطة Enterprise. تواصل معنا للتفاصيل.

تعرف على المزيد حول تكامل BigQuery →

ذات صلة

• واجهة برمجة تطبيقات اختصار الروابط - إنشاء وتحديث الروابط برمجياً
• Webhooks - إخطارات النقرات في الوقت الفعلي
• تكامل BigQuery - وصول SQL مباشر إلى بيانات النقرات
• تكامل Zapier - التكاملات الخالية من الأكواد