الـ API للمطوّرين
مفاتيح API ونقاط النهاية وحدود المعدل والـ Webhooks
المقالات: 9
نظرة عامة على الـ API
العنوان الأساسي وبيئة Sandbox والإصدارات وتنسيق البيانات والترقيم والمصادقة: ما تحتاج إلى معرفته قبل أول استدعاء لواجهة LinkHarbor REST API.
مفاتيح API ورموز الوصول
أنشئ مفتاح API في لوحة التحكم، واختر النطاقات، واستبدله برمز صالح لمدة 15 دقيقة، واحفظه بأمان وألغِه عند الحاجة، خطوة بخطوة.
النطاقات (Scopes): كل صلاحيات الـ API
كل النطاقات الـ 15 لمفاتيح API واتصالات الذكاء الاصطناعي: ما يسمح به كل نطاق، واسمه في لوحة التحكم، وما لا يستطيعه أي مفتاح API.
نقاط نهاية الـ API حسب المجال
كل نقطة نهاية يمكنك استخدامها بمفتاح API، مرتّبة حسب المجال، مع طريقة HTTP والمسار والنطاق المطلوب وما تقوم به.
حدود المعدل: كل الحدود والترويسات
كم طلبًا في الدقيقة تسمح به واجهة LinkHarbor API، وما الحجم الأقصى للطلب، وكيف تقرأ الترويسات، وكيف تتعامل مع الخطأ 429 بشكل صحيح.
تنسيق أخطاء الـ API ورموز الأخطاء
كيف تُبنى استجابات الأخطاء في واجهة LinkHarbor API، وما معنى أهم رموز الأخطاء، وكيف ينبغي أن تتفاعل شيفرتك معها.
Webhooks: الأحداث والحمولة والتوقيع
أعِدّ الـ Webhooks في لوحة التحكم، واستقبل عمليات التسليم، وتحقّق من توقيع HMAC، مع أمثلة لـ curl وNode.js وPHP.
إرسال المبيعات والبيانات المخصصة
استخدم Callbacks البيع لربط المبيعات من متجرك بالنقرات على الروابط، وتكامل Custom (API) لإرسال بيانات حيّة من أدواتك الخاصة إلى صفحتك.
خطوة بخطوة: تحديث صفحة عبر الـ API
من مفتاح API إلى الإصدار المنشور: أضف رابطًا، وانقله إلى الأعلى، وغيّر التصميم، وتحقّق من المسودة، ثم انشر، باستخدام curl وjq.