Skip to main content
هذا القسم مرجعٌ تفاعليٌّ كامل لواجهة Fatorly Integration API (الإصدار v1). تُدرَج كل نقطة نهاية في الشريط الجانبي ضمن API Reference، مع مُعاملاتها ومخطّطات الطلب والاستجابة، إضافةً إلى ساحة تجريب داخل الصفحة لإرسال طلبات حيّة ومشاهدة الاستجابات الفعلية.
هل أنت جديد على الواجهة؟ ابدأ بأدلة نظرة عامة والمصادقة والبدء السريع، ثم استخدم هذا المرجع للاطّلاع على تفاصيل نقاط النهاية كاملةً. صفحات نقاط النهاية المولّدة متاحة بالإنجليزية فقط.

​
عنوان الأساس (Base URL)

جميع نقاط النهاية مُصدَّرة تحت /v1 (مثل POST /v1/invoices). تستخدم الأمثلة في هذا المرجع الإنتاج؛ بدّل المضيف للاختبار.

​
القيم المسموح بها

تقبل الحقول ذات المفردات المغلقة هذه القيم حصرًا (وهي مُعلنة أيضًا كـ enum في مخطّط كل نقطة نهاية أدناه، مع مثال مُعبّأ مسبقًا في ساحة التجريب):

​
المصادقة

يتطلّب كل طلب مفتاح API الخاص بك في ترويسة X-Api-Key.
1

أنشئ مفتاح API

من المنصّة، انتقل إلى الإعدادات ← مفاتيح API وأنشئ مفتاحًا. يبدو المفتاح بالشكل fat_… ويُعرَض مرّة واحدة فقط — انسخه فورًا. راجع مفاتيح API.
2

أضِفه إلى ساحة التجريب

في أي صفحة نقطة نهاية أدناه، افتح لوحة Authorization والصق مفتاحك في حقل X-Api-Key.
3

أرسل طلبًا

عبّئ المُعاملات واختر Send لاستدعاء واجهة Integration API الحيّة.
عامِل مفتاح API كأنّه كلمة مرور. تعمل الاستدعاءات على بيانات شركتك الفعلية. إذا فُقد المفتاح أو تسرّب، فألغِه من الإعدادات ← مفاتيح API وأنشئ مفتاحًا جديدًا.