الأساسيات
بنية نقاط النهاية
يتم الوصول إلى جميع نقاط نهاية REST API عبر عنوان URL الأساسي:
https://api.finlight.me
تُبنى نقاط النهاية باستخدام طرق HTTP القياسية، وتتوقّع إرسال المعاملات على شكل سلاسل استعلام (query strings).
إدارة إصدارات API
تتم إدارة إصدارات REST API لضمان التوافق مع الإصدارات السابقة. الإصدار الحالي هو v2. تتضمّن جميع نقاط النهاية رقم الإصدار في عنوان URL:
https://api.finlight.me/v2/...
وهذا يتيح التحديثات المستقبلية دون كسر عمليات الدمج القائمة.
ترويسات المصادقة
صادِق على طلبات REST API الخاصة بك بتضمين مفتاح API في ترويسة X-API-KEY:
X-API-KEY: YOUR_API_KEY
إذا كنت تستخدم مكتبات العميل الخاصة بنا، فستتم معالجة هذه الترويسة تلقائيًا نيابةً عنك. يمكنك الحصول على مفتاح API الخاص بك من لوحة تحكم finlight.