G-Ledger

حساب الأستاذ — لكل القطاعات
الرئيسيةتسجيل الدخول
REST API v1

G-Ledger Public API v1

اربط أنظمتك الخارجية (Odoo، Bayzat، Workday وغيرها) مباشرة بنظام G-Ledger عبر REST API

الرابط الأساسي

https://app.g-ledger.com/api/v1/

المصادقة

جميع الطلبات تتطلب مفتاح API يُرسل في ترويسة Authorization كـ Bearer Token. احصل على مفتاحك من الإعدادات.

Authorization: Bearer glk_your_api_key_here
احصل على مفتاح API من الإعدادات→

نقاط الوصول

الطريقةنقطة الوصولالوصف
GET/api/v1/accountsقائمة شجرة الحسابات
GET/api/v1/journal-entriesقائمة القيود اليومية
POST/api/v1/journal-entriesإنشاء قيد يومي
GET/api/v1/customersقائمة العملاء
POST/api/v1/customersإنشاء عميل
GET/api/v1/vendorsقائمة الموردين
POST/api/v1/vendorsإنشاء مورد
GET/api/v1/productsقائمة المنتجات
POST/api/v1/productsإنشاء منتج
GET/api/v1/invoicesقائمة الفواتير
POST/api/v1/invoicesإنشاء فاتورة
GET/api/v1/employeesقائمة الموظفين
GET/api/v1/webhooksقائمة أحداث Webhook المتاحة
POST/api/v1/webhooksتسجيل Webhook لتلقي الأحداث

شكل الاستجابة

جميع الاستجابات بصيغة JSON مع حقل data يحتوي البيانات وحقل total لعدد النتائج.

{ "data": [...], "total": 42, "page": 1, "limit": 50, "pages": 1 }

التصفح

النقاط التي تدعم التصفح تقبل معاملات page و limit. الحد الأقصى لـ limit هو 100.

GET /api/v1/journal-entries?page=2&limit=25

أمثلة الاستخدام

GET مثال
curl -X GET "https://app.g-ledger.com/api/v1/accounts" \
  -H "Authorization: Bearer glk_your_api_key_here" \
  -H "Content-Type: application/json"
POST مثال
curl -X POST "https://app.g-ledger.com/api/v1/journal-entries" \
  -H "Authorization: Bearer glk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-03-30",
    "description": "Sales revenue",
    "lines": [
      { "accountId": "acc_cash", "debit": 1150, "credit": 0 },
      { "accountId": "acc_revenue", "debit": 0, "credit": 1000 },
      { "accountId": "acc_vat", "debit": 0, "credit": 150 }
    ]
  }'

رموز الأخطاء

الرمزالوصف
401غير مصرح — مفتاح API غير صالح أو مفقود
400طلب غير صالح — بيانات مفقودة أو غير صحيحة
404غير موجود — المورد غير موجود
429تجاوز الحد — انتظر قبل المحاولة مرة أخرى
500خطأ في الخادم — حاول مرة أخرى لاحقًا

حدود الاستخدام

100 طلب في الدقيقة لكل مفتاح API. عند تجاوز الحد، ستحصل على رد 429 Too Many Requests.

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

سجّل الآن واحصل على مفتاح API خلال دقيقة واحدة

ابدأ مجانًااحصل على مفتاح API من الإعدادات