REST API · v2.0

قيود API
ابنِ تكاملاتك المحاسبية الخاصة

واجهة برمجة تطبيقات (REST API) تغطي 19 موردًا محاسبيًا، من الفواتير والعملاء إلى المخزون والقيود اليومية، مع توثيق كامل ومصادقة آمنة بمفتاح خاص لكل منشأة.

14 يومًا مجانًا
بدون بطاقة ائتمان
ردود JSON



api.qoyod.com / invoices
# Create a sales invoice
POST https://api.qoyod.com/2.0/invoices
API-KEY: your_api_key

{
  “contact_id”: 142,
  “issue_date”: “2026-05-06”,
  “line_items”: [ … ]
}

→ 201 Created  # JSON

19
موردًا متاحًا
v2.0
إصدار مستقر
JSON
صيغة الردود
HTTPS
اتصال آمن

ماذا يتيح لك قيود API؟

أربع حالات استخدام شائعة تختصر ساعات عمل يدوية وتفتح الباب أمام نمو لا يقف عند حدود الواجهة الجاهزة.

ربط متجرك الإلكتروني

زامن طلبات وفواتير متجرك على Salla أو Shopify أو منصتك الخاصة مع قيود تلقائيًا، دون إدخال يدوي.

أتمتة الفوترة

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

مزامنة العملاء وCRM

وحّد بيانات عملائك بين قيود ونظام إدارة علاقات العملاء، وحدّث الأرصدة آنيًا.

تقارير وتحليلات مخصصة

اسحب القيود المحاسبية والفواتير إلى أدوات BI لبناء لوحات تحليلية تخدم قرارك.

19 موردًا متاحًا عبر API

يغطي قيود API كل ما تحتاجه لبناء تكامل محاسبي شامل، فتستطيع قراءة البيانات وإنشاءها وتحديثها وحذفها وفق صلاحياتك.

الحسابات
Accounts
المنتجات
Products
المخزون
Inventories
فئات المنتجات
Product Categories
وحدات المنتجات
Product Units
الموردون
Vendors
أوامر الشراء
Purchase Orders
الفواتير الواردة
Bills
مدفوعات الفواتير الواردة
Bill Payments
الفواتير الواردة المبسطة
Simple Bills
مدفوعات الفواتير المبسطة
Simple Bill Payments
إشعارات المدين
Debit Notes
العملاء
Customers
عروض الأسعار
Quotes
الفواتير الصادرة
Invoices
مدفوعات الفواتير الصادرة
Invoice Payments
إشعارات الدائن
Credit Notes
سندات القبض
Receipts
القيود اليومية
Journal Entries

كيف تبدأ في 4 خطوات

من إنشاء حسابك إلى أول استدعاء ناجح، في أقل من ساعة عمل واحدة.

1

سجّل في قيود

أنشئ حسابك على قيود وفعّل خطتك المناسبة. التجربة المجانية متاحة لمدة 14 يومًا.

2

احصل على مفتاح API

من إعدادات المنشأة العامة، أنشئ مفتاح API الخاص بك واحفظه في مكان آمن.

3

اقرأ التوثيق

تصفّح توثيق API الكامل على apidoc.qoyod.com، مع أمثلة جاهزة لكل مورد من الموارد التسعة عشر.

4

ابدأ التكامل

نفّذ أول استدعاء عبر رأس API-KEY، واستقبل الردود بصيغة JSON واضحة.

أمان وموثوقية على مستوى المؤسسات

نطبّق ممارسات حماية صارمة لأن بياناتك المحاسبية أهم ما لديك.

تشفير HTTPS كامل

كل استدعاء يمر عبر قناة مشفرة بشهادة TLS حديثة، ولا تُقبَل الاتصالات غير الآمنة.

مفتاح API خاص لكل منشأة

تُولّد المفتاح من إعدادات منشأتك العامة، ويمكنك إبطاله وتجديده في أي وقت.

JSON واضح وقابل للقراءة

كل الردود بصيغة JSON منظّمة، مع رموز HTTP قياسية (200 و201 و400 و404 و500).

بحث وفرز قويّان

كل نقاط الفهرسة تدعم Ransack، فابحث وافرز بأي معامل، مثل q[sku_cont]=acc.

إصدار مستقر (v2.0)

الإصدار الحالي مُجرَّب في الإنتاج ويُستخدم من شركاء فعليين، ولا نُحدثه بشكل يكسر التكاملات القائمة.

صلاحيات دقيقة

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

API أم تكامل جاهز؟

طريقتان لربط نظامك بقيود — اختر ما يناسب حجم فريقك واحتياجك.

التكاملات الجاهزة

ابدأ خلال دقائق دون أي برمجة، عبر تكاملاتنا الرسمية مع منصات السوق السعودي.

  • هيئة الزكاة والضريبة والجمارك (الفوترة الإلكترونية)
  • زابير (Zapier) لربط آلاف التطبيقات
  • سلة وزد ومنصات التجارة الإلكترونية
  • لا تحتاج فريق تطوير

شاهد كل التكاملات الجاهزة ←

للمطوّرين

قيود API

مرونة كاملة لبناء أي تكامل مخصص يخدم نظامك أو منتجك الخاص.

  • 19 موردًا قابلًا للقراءة والكتابة
  • توثيق تفاعلي على Postman
  • مصادقة آمنة بمفتاح خاص
  • متاح بدون رسوم إضافية لمشتركي قيود

افتح التوثيق ←

الأسئلة الشائعة

أبرز ما يسأله المطورون قبل بناء أول تكامل مع قيود.

ما هي تكلفة استخدام API قيود؟

API قيود متاح مجانًا لجميع المشتركين في خطط قيود المدفوعة دون رسوم إضافية، وتُحتسب وفق سياسة الاستخدام العادل.

هل يحتاج التكامل إلى مطوّر؟

نعم، استخدام API يتطلب معرفة تقنية بأساسيات REST وJSON. إن لم يكن لديك فريق تطوير، فالتكاملات الجاهزة عبر صفحة التكاملات قد تغطي احتياجك.

ما الفرق بين API والتكاملات الجاهزة؟

التكاملات الجاهزة (مثل سلة وزابير وهيئة الزكاة) تعمل بنقرة واحدة دون برمجة. أما API فيمنحك مرونة كاملة لبناء أي تكامل مخصص بنفسك.

ما حدود الاستخدام (Rate Limits)؟

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

هل API آمن؟

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

ما الموارد التي يغطيها API؟

يغطي API 19 موردًا تشمل العملاء والمنتجات والفواتير والمخزون والقيود اليومية والموردين وأوامر الشراء وغيرها، أي ما يحتاجه أي تكامل محاسبي شامل.

جاهز لبناء تكاملك مع قيود؟

افتح حسابك، احصل على مفتاحك، وابدأ أول استدعاء خلال دقائق.