ابدأ مجاناً
14 يوماً تجريبي مجاني - بدون بطاقة ائتمان
Hisab
الأسعار
المبيعات: 64 43 22 649 212+
ابدأ مجاناً

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

تسجيل الدخول
مرجع API v1.0

وثائق API الخاصة بـ Hisab

دمج Hisab في تطبيقك باستخدام REST API الشامل الخاص بنا. قم بإنشاء وإدارة وإرسال الفواتير المتوافقة مع DGI بشكل برمجي.

مرجع API
المصادقة
الفواتير
الفواتير المتكررة
العملاء
Webhooks

البدء

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

عنوان URL الأساسي
https://hisab.ma/api/v1

قم بإجراء طلبك الأول

  1. احصل على مفتاح API الخاص بك من لوحة التحكم
  2. قم بتضمينه في رأس Authorization
  3. قم بإجراء أول استدعاء API
حدود المعدل
يتم تحديد طلبات API إلى 100 طلب في الدقيقة لكل مفتاح API. قم بالترقية إلى خطط أعلى لحدود متزايدة.

المصادقة

يستخدم Hisab API مفاتيح API للمصادقة. قم بتضمين مفتاح API الخاص بك في رأس Authorization كـ Bearer token:

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

أنواع المفاتيح

مفتاح سري
استخدم لعمليات الخادم إلى الخادم. لا تعرض أبدًا في الكود من جانب العميل.
hisab_live_xxxxxxxxxxxxx
مفتاح قابل للنشر
استخدم لعمليات من جانب العميل. وصول للقراءة فقط.
not yet developed

الأخطاء

يستخدم Hisab API رموز استجابة HTTP التقليدية للإشارة إلى نجاح أو فشل طلب API.

400
طلب غير صحيح
الطلب غير صالح أو مشوه.
401
غير مصرح
مفتاح API الخاص بك غير صالح.
403
محظور
ليس لديك الإذن للوصول إلى هذا المورد.
404
غير موجود
المورد المطلوب غير موجود.
429
طلبات كثيرة جدًا
تجاوزت حد المعدل.
500
خطأ في الخادم
حدث خطأ في خوادمنا.

Webhooks

تسمح لك Webhooks بتلقي إشعارات HTTP في الوقت الفعلي عند حدوث أحداث معينة في حساب Hisab الخاص بك.

الأحداث المتاحة

invoice.created

تم إنشاء فاتورة جديدة

invoice.finalized

تم إنهاء فاتورة

invoice.sent

تم إرسال فاتورة إلى العميل

invoice.paid

تم وضع علامة على الفاتورة كمدفوعة

invoice.payment_failed

فشل الدفع للفاتورة

invoice.canceled

تم إلغاء فاتورة

customer.created

تم إنشاء عميل جديد

customer.updated

تم تحديث تفاصيل العميل

مكتبات SDK

يوفر Hisab مكتبات رسمية لتبسيط التكامل:

Node.js / TypeScript SDK
npm install hisab-sdk

Official SDK with full TypeScript support, auto-pagination, and webhook verification.

عرض الوثائق
PHP
Coming soon
composer require hisab/php
Python
Coming soon
pip install hisab
Ruby
Coming soon
gem install hisab
POST

Create Invoice

إنشاء فاتورة جديدة مع عناصر السطر والتفاصيل الضريبية.

curl -X POST https://hisab.ma/api/v1/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "d8e6b416-e946-48f8-994d-309906db0fe4",
    "issue_date": "2025-11-27",
    "due_date": "2025-12-27",
    "currency": "MAD",
    "payment_terms": "Net 30",
    "notes": "Thank you for your business",
    "items": [
      {
        "description": "Web Development Services",
        "quantity": 10,
        "unit_price": 500.00,
        "tax_rate": 20
      },
      {
        "description": "Hosting - Annual Plan",
        "quantity": 1,
        "unit_price": 1200.00,
        "tax_rate": 20
      }
    ]
  }'

بحاجة إلى مساعدة؟

اتصل بفريق دعم المطورين للحصول على المساعدة في تكامل API.

contact@hisab.ma →
    مرجع API - Hisab | Hisab - E-Invoicing Morocco