اضغط على تشغيل للبدء · مسافة للإيقاف المؤقت · ← → للتقديم أو الإرجاع 5 ثوانٍ · C لإظهار الترجمة النصية أو إخفائها
الفصول
ما الغاية من واجهة برمجة التطبيقات للمطوّرين؟
«المطوّرون» هي وحدة التحكم الخاصة بواجهة LinkinLegal البرمجية للعقوبات. أنشئ مفاتيح API التي تستخدمها أنظمتك، وتابع كل استدعاء في مخططات الاستخدام وسجل الطلبات، واطّلع على باقة API وفواتيرك، لكي تتمكن أدوات قبول العملاء والتحقق من هويتهم (KYC) لديك من فحص الأسماء مقابل بيانات العقوبات والأشخاص المعرّضين سياسيًا نفسها المستخدمة في التطبيق.
لمن هذه الميزة
فرق التطوير
إنشاء المفاتيح، وتشغيل البدء السريع، وتتبّع أي استدعاء من خلال معرّف الطلب.
مسؤولو الامتثال والعمليات
متابعة أحجام الاستدعاءات ونشاط المفاتيح وباقة API في مكان واحد.
المشكلات التي تعالجها
الفحص ضمن إجراءات قبول العملاء لديك
استدعِ نقطتي النهاية search وmatch من خوادمك، ليُفحص العملاء والأطراف المقابلة الجدد في الأنظمة التي يستخدمها فريقك بالفعل.
مفاتيح تبقى تحت سيطرتك
امنح كل نظام مفتاحه الخاص بتاريخ انتهاء صلاحية، واطّلع على آخر استخدام له، وألغِه فور انتفاء الحاجة إليه.
كل استدعاء مسجَّل
الاستخدام حسب اليوم ونقطة النهاية والمفتاح، إضافةً إلى سجل لكل طلب مع حالته ومدته ومعرّف الطلب.
طريقة استخدام واجهة برمجة التطبيقات للمطوّرين
تعرض كل خطوة الشاشة الفعلية. مرّر المؤشر فوق علامة مرقّمة، أو فوق الملاحظة المقابلة لها، لمعرفة وظيفة كل عنصر تحكّم.
الحصول على وصول إلى API
افتح «المطوّرون» من قائمة الحساب. إلى أن تصبح لدى حسابك باقة API، تعرض وحدة التحكم طريقة الحصول عليها: يتفق فريقنا معك على الواجهات البرمجية والسعر وباقة شهرية أو سنوية، ويبدأ الوصول عند سداد الفاتورة الأولى.
- لا تُتاح باقة API إلا لمالك اشتراك LinkinLegal متكرر، وليس لأعضاء مساحة العمل أو حاملي التصريح اليومي أو الأسبوعي.
- تمنح كل باقة استدعاءات غير محدودة لواجهتها البرمجية، ضمن حد استخدام عادل قدره 120 طلبًا في الدقيقة.
- باقة API مستقلة عن اشتراكك في LinkinLegal، وتُسدَّد بموجب فاتورة.
على هذه الشاشة
التنقل في وحدة التحكم
عندما تكون لديك باقة API، تُفتح «المطوّرون» على «نظرة عامة»: باقتك والاستدعاءات هذا الشهر والمفاتيح النشطة وحد المعدل. وتؤدي القائمة الجانبية إلى «مفاتيح API» و«الاستخدام» و«الفوترة» و«توثيق API».
- «البدء السريع» استدعاء curl جاهز للتشغيل: أضف مفتاحك وأرسله.
- يغطي مخطط «الاستدعاءات يوميًا» آخر 30 يومًا، بتوقيت UTC.
- وفي الأسفل، يسرد قسم «الطلبات الأخيرة» أحدث استدعاءاتك مع حالتها.
على هذه الشاشة
إنشاء مفاتيح API وإدارتها
في «مفاتيح API»، انقر «إنشاء مفتاح»، وامنح المفتاح اسمًا يسهل عليك التعرف عليه، مثل اسم النظام الذي يستخدمه، واختر موعد انتهاء صلاحيته. يظهر كل مفتاح في القائمة مع أحرفه الأولى وتاريخ انتهاء صلاحيته وآخر استخدام له.
- تتراوح مدة الصلاحية بين ساعة واحدة وسنة واحدة، أو «بلا انتهاء صلاحية». ولا يمكن تغييرها لاحقًا.
- حتى 20 مفتاحًا نشطًا لكل حساب، وحتى 60 حرفًا للاسم.
- يوقف «إلغاء» المفتاح فورًا. وتبقى المفاتيح الملغاة في القائمة بلون باهت.
على هذه الشاشة
نصيحة: استخدم مفتاحًا واحدًا لكل نظام، مثل خدمة قبول العملاء أو مهمة ليلية مجدولة، حتى لا يكلّفك تسرّب مفتاح سوى ذلك المفتاح وحده، لا جميع مفاتيحك.
احفظ مفتاحك: لا يُعرض إلا مرة واحدة
بعد «إنشاء مفتاح»، يعرض مربع الحوار المفتاح كاملًا. هذه هي المرة الوحيدة التي ستراه فيها، لذا انسخه إلى أداة إدارة الأسرار لديك قبل النقر على «تم». بعد ذلك يرسله خادمك كرمز Bearer في ترويسة Authorization.
- عنوان URL الأساسي: https://api.linkinlegal.com/v1. على سبيل المثال: GET /sanctions/search أو POST /sanctions/match.
- يفحص POST /sanctions/match/batch ما يصل إلى 100 شخص أو جهة في استدعاء واحد.
- فقدت مفتاحًا؟ ألغِه وأنشئ مفتاحًا جديدًا.
على هذه الشاشة
متابعة الاستخدام وكل طلب
يعرض «الاستخدام» مخططًا للاستدعاءات اليومية على مدى 7 أو 30 أو 90 يومًا، ويوزّعها حسب نقطة النهاية والمفتاح. وفي الأسفل، يسرد سجل الطلبات كل استدعاء. اختر صفًا لعرض معرّف الطلب والطلب الذي أرسلته.
- صفِّ السجل حسب الحالة («ناجحة» أو «أخطاء») أو حسب المفتاح.
- الحالات الخضراء ناجحة، والحمراء أخطاء، مثل 402 عند عدم وجود باقة أو 429 عند تجاوز حد المعدل.
- يعرض السجل 25 طلبًا في كل صفحة.
على هذه الشاشة
نصيحة: عند التواصل مع الدعم بشأن استدعاء ما، أرفق معرّف الطلب. ويضعه زر «نسخ المعرّف» في الحافظة.
مراجعة باقة API والفواتير
تعرض «الفوترة» كل واجهة API في باقتك مع سعرها وتاريخ تجديدها، والفاتورة التالية، وكل دفعة مع رابط إلى فاتورتها. لإضافة واجهة API أو إلغائها، تواصل مع فريقنا.
- ترسل Stripe الفواتير بالبريد الإلكتروني، ويبدأ الوصول عند سداد الفاتورة الأولى.
- إذا فشلت دفعة، تنبّهك «نظرة عامة» قبل أن يتوقف الوصول.
- تظل الباقة الملغاة سارية حتى نهاية الفترة التي دفعت مقابلها.
على هذه الشاشة
الخطوة 01 من 06
كل إمكانات واجهة برمجة التطبيقات للمطوّرين
المكوّنات الأساسية التي تقوم عليها الجولة التعريفية، وما يقدّمه لك كلٌّ منها.
فحص العقوبات والأشخاص المعرّضين سياسيًا
ابحث في السجلات بالاسم، أو قيّم شخصًا أو شركة باستخدام match، بما يصل إلى 100 شخص أو جهة في استدعاء مجمّع واحد.
مفتاح لكل نظام
سمِّ كل مفتاح باسم النظام الذي يستخدمه، واختر مدة صلاحيته، وألغِه عند انتفاء الحاجة إليه.
الاستخدام في لمحة
الاستدعاءات اليومية على مدى 7 أو 30 أو 90 يومًا، حسب نقطة النهاية والمفتاح.
سجل لكل طلب
صفِّ حسب الحالة أو المفتاح، وافتح أي استدعاء لعرض معرّف الطلب والطلب نفسه.
البدء السريع
استدعاء curl جاهز للنسخ يرسل مفتاحك كرمز Bearer.
حد معدل للاستخدام العادل
120 طلبًا في الدقيقة لكل حساب، تتشاركها جميع مفاتيحك.
السداد بموجب فاتورة
باقتك وتاريخ تجديدها وكل فاتورة أو إشعار دائن.
توثيق API كامل
البدء السريع والمصادقة والأخطاء ومرجع كامل على docs.linkinlegal.com.
نصائح لاستخدام صحيح
احتفظ بالمفاتيح على خادمك
لا تضع مفتاحًا أبدًا في شيفرة المتصفح أو تطبيقات الهاتف المحمول. اقرأه من متغير بيئة أو من أداة لإدارة الأسرار.
انسخ المفتاح فورًا
لا يُعرض كاملًا إلا مرة واحدة. وإذا فقدته، فألغِه وأنشئ مفتاحًا جديدًا.
اختر مدة الصلاحية بعناية
لا توجد مدة افتراضية، ولا يمكن تغييرها لاحقًا. لتدوير المفاتيح، أنشئ المفتاح الجديد وانشره، ثم ألغِ المفتاح القديم.
اجمع الفحص الجماعي في استدعاءات مجمّعة
يفحص POST /sanctions/match/batch ما يصل إلى 100 شخص أو جهة، ويُحتسب طلبًا واحدًا ضمن حد المعدل.
سجّل معرّف الطلب
تحمل كل استجابة ترويسة X-Request-Id. وبها يستطيع الدعم العثور على استدعائك بعينه.
لا تُعد محاولة 401 أو 402 أو 403
تتعلق هذه الأخطاء بالمفتاح أو الباقة أو الاشتراك، لذا سيفشل الاستدعاء نفسه مجددًا. أعد المحاولة في حالتي 429 و503 فقط.
الحالات التي ستراها
كل عمل يجري في الخلفية يُظهر حالته دائمًا. إليك معنى كل تسمية.
- نشطةباقة API مفعّلة وتتجدد في التاريخ المعروض.
- أُرسلت الفاتورةأعدّ فريقنا الباقة. ويبدأ الوصول إلى API عند سداد الفاتورة المرسلة بالبريد الإلكتروني.
- فشل الدفعفشلت آخر دفعة لباقة API. ويتوقف الوصول إذا لم تنجح أي دفعة.
- أُلغيلم يعد المفتاح يعمل، وتُرفض الاستدعاءات التي تستخدمه.
- انتهت صلاحيتهتجاوز المفتاح تاريخ انتهاء صلاحيته. أنشئ مفتاحًا جديدًا.
- 429أكثر من 120 طلبًا في الدقيقة. انتظر المدة المحددة في Retry-After، ثم أعد المحاولة.
مالك اشتراك متكرر في تطبيق LinkinLegal. لا يرى أعضاء مساحة العمل رابط «المطوّرون»، ولا يمكن لحاملي التصريح اليومي أو الأسبوعي الحصول على وصول إلى API.
تواصل مع فريقنا من وحدة التحكم. نتفق معك على الواجهات البرمجية والسعر وباقة شهرية أو سنوية، وترسل Stripe الفاتورة بالبريد الإلكتروني. ويبدأ الوصول عند سدادها.
تمنح الباقة استدعاءات غير محدودة لواجهتها البرمجية. ويسري حد معدل للاستخدام العادل قدره 120 طلبًا في الدقيقة على الحساب بأكمله، وتتشاركه جميع المفاتيح.
لا. لا تُخزَّن إلا قيمة مُجزّأة من المفتاح، لذا لا يُعرض المفتاح كاملًا إلا مرة واحدة عند إنشائه. ألغِ المفتاح المفقود وأنشئ مفتاحًا جديدًا.
401: المفتاح مفقود أو غير معروف أو ملغى أو منتهي الصلاحية. 402: لا توجد لدى الحساب باقة مفعّلة لتلك الواجهة البرمجية. 429: تجاوزت 120 طلبًا في الدقيقة. انتظر المدة المحددة في Retry-After، ثم أعد المحاولة.
اختر «توثيق API» من قائمة وحدة التحكم، أو انتقل إلى docs.linkinlegal.com للاطلاع على البدء السريع والمصادقة وحدود المعدل والأخطاء والمرجع الكامل.
تابع الاستكشاف
ميزات ذات صلة
- أين تجدها
- قائمة الحساب ← المطوّرون