LGCD
تكاملات · خطة Business

واجهة REST و 31 webhook
لربط كونسيرجك بأي شيء.

PriceLabs، Turno، Metabase، Zapier، n8n، برنامج محاسبتك… لا حاجة لإدخال مزدوج. واجهتنا تكشف كل ما يحدث في لوحة تحكمك، والـ webhooks تُشعِر أدواتك في الوقت الحقيقي.

ابدأ تجربتي المجانية 📘 وثائق OpenAPI

متاح في خطة Business. تذاكر Sanctum بصلاحيات دقيقة. حد المعدل 60 طلب/دقيقة.

api.lgcd.ma/v1/docs
واجهة REST و Webhooks

21

نطاقات API دقيقة

31

أحداث webhook

60

طلب/دقيقة لكل تذكرة

HMAC

موقع بـ SHA-256 على كل webhook

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

ما تربطه وكالات حقيقية فوقها.

📈

إدارة العائد

PriceLabs · Wheelhouse · Beyond

قراءة التقويم المُمَركَز لعدة عقارات ودفع التسعيرات الموسمية في الوقت الحقيقي. تتعدّل أسعارك تلقائيًا حسب الطلب المحلي.

calendar:read rates:read rates:write
🧹

عمليات التنظيف

Turno · Properly · Breezeway

تُرسَل مهام التنظيف إلى فريقك عبر تطبيقاتهم المخصصة (قائمة، صور قبل/بعد). Webhooks على الإسناد، البداية، النهاية.

cleaning:read cleaning:write
🛠

صيانة معهَّدة

شبكة حرفيين · إدارة الموردين

إنشاء تذكرة تلقائيًا في برنامج مزودك. تصعيد Slack/PagerDuty على العاجل (تسريب، عطل مكيف).

maintenance:read maintenance:write
📊

تحليلات وتقارير

Metabase · Looker Studio · Power BI

مؤشرات الفندقة محسوبة مسبقًا: نسبة الإشغال، ADR، RevPAR، الإيراد الإجمالي/الصافي لكل عقار أو فترة. لوحاتك محدثة دون إعادة حساب.

reports:read
🧾

محاسبة المالك

Indy · Macompta.ma · Sage

استرجاع الكشوف الشهرية (الإيرادات، العمولات، الصافي للتحويل). دفع تلقائي نحو محاسبة المالك، إطلاق تحويل.

statements:read invoices:read owners:read
💬

CRM للضيف

ActiveCampaign · Brevo · n8n

Webhook على حجز مؤكَّد ← تسلسل تلقائي قبل الإقامة. دفع رسالة واتساب بقالب عبر API لإشعارات مخصصة.

bookings:read whatsapp:write
🔄

مزامنة OTAs

Hostaway · Hospitable · Smoobu

إنشاء/تعديل/أرشفة عقار يُنبَّه عنها في الوقت الحقيقي. ضبط مصادر iCal الخارجية (Airbnb، Booking) عبر API.

properties:read properties:write
🔐

الأمان والامتثال

Datadog · Splunk · Wazuh

قراءة سجل التدقيق (قانون 09-08، احتفاظ 3 سنوات) ودفع SIEM للأحداث الحرجة. للوكالات الخاضعة للتدقيق.

audit:read
🤖

أتمتة بدون كود

Zapier · Make · n8n

اربط أي webhook بمئات التطبيقات الطرفية دون كتابة سطر كود. Slack، Google Sheets، Notion، Trello، إلخ.

جميع أحداث webhook
واجهة REST · v1

واجهة نظيفة، موثقة، يمكن توقعها.

صيغة JSON قياسية، ترقيم Laravel، رموز HTTP متسقة، تذاكر Sanctum بصلاحيات دقيقة. وثائق OpenAPI 3 محدثة تلقائيًا وقابلة للاستكشاف عبر Swagger.

  • ✓تذاكر Sanctum بصلاحيات دقيقة: تذكرة قراءة فقط لـ Metabase، تذكرة كتابة لـ Zapier.
  • ✓عزل تلقائي للمستأجر: من المستحيل الوصول إلى بيانات وكالة أخرى، حتى بالخطأ.
  • ✓رؤوس حد المعدل القياسية (X-RateLimit-*) لتراجع نظيف من جهة العميل.
  • ✓انتهاء صلاحية اختياري للتذاكر، إلغاء فوري من لوحة التحكم.
📘 Swagger UI 📄 openapi.yaml
GET /api/v1/reports/revenue 
# سرد الإيرادات + ADR + RevPAR لشهر يوليوز
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.example.com/v1/reports/revenue?from=2026-07-01&to=2026-07-31&granularity=day"

{
  "from": "2026-07-01",
  "to": "2026-07-31",
  "currency": "MAD",
  "data": {
    "global": {
      "gross_revenue": 142500,
      "net_revenue": 128250,
      "nights_booked": 186,
      "adr": 766.13,
      "revpar": 459.68
    },
    "per_property": [...],
    "series": [...]
  }
}
Webhooks · 31 حدثًا

تُنبَّه في الوقت الحقيقي حين يتحرك شيء.

كل webhook موقع بـ HMAC-SHA256 ومُسلَّم مع إعادة محاولة أُسية (5 محاولات على 24 ساعة). يُدعَم الـ wildcard (`booking.*` للاشتراك في عائلة كاملة من الأحداث).

الحجوزات

  • booking.created حجز جديد
  • booking.confirmed حجز مؤكَّد (انتقل من pending إلى confirmed)
  • booking.updated حجز مُعدَّل
  • booking.cancelled حجز مُلغى
  • booking.checked_in تأكيد الوصول
  • booking.checked_out تأكيد المغادرة
  • booking.no_show الضيف لم يظهر (no-show)
  • booking.payment_received تحصيل عربون الضيف عبر CMI (الموقع المصغر)

العقارات

  • property.created عقار جديد مُنشَأ
  • property.updated عقار مُعدَّل (السعر، الوصف…)
  • property.archived عقار مؤرشف
  • property.rate_changed تسعيرة موسمية مُضافة / مُعدَّلة / محذوفة (إدارة العائد)

التنظيف

  • cleaning.assigned مهمة مُعيَّنة
  • cleaning.completed مهمة منجزة
  • cleaning.skipped مهمة متجاوَزة (لإعادة التخطيط)

الصيانة

  • maintenance.created تذكرة مُنشأة
  • maintenance.assigned تذكرة مُعيَّنة لمتدخل
  • maintenance.urgent تذكرة مُعلَّمة عاجلة (تصعيد ops)
  • maintenance.resolved تذكرة مُحلَّة

الفواتير

  • invoice.sent فاتورة مُرسَلة
  • invoice.paid فاتورة مدفوعة

المزامنة

  • ical.conflict_detected تعارض iCal مكتشف
  • ical.sync_failed فشل مزامنة iCal (رابط غير صالح / مصدر معطل)

واتساب

  • whatsapp.message_failed فشل إرسال رسالة واتساب

التدقيق / الأمان

  • audit.critical_event حدث حرج في سجل التدقيق

الملاك

  • owner.statement_ready كشف شهري متاح (الأول من الشهر التالي)

اشتراك SaaS

  • subscription.renewed اشتراك مُجدَّد بعد دفع ناجح

تقييمات الضيوف

  • review.received تقييم ضيف جديد (إدارة السمعة، تنبيه تقييم منخفض)

المدفوعات

  • payment.succeeded دفع ناجح (اشتراك أو حجز الموقع المصغر)
  • payment.failed دفع فاشل (تنبيه / إعادة)

site.webhook_group_finance

  • tax_report.generated site.webhook_event_tax_report.generated
Webhook · payload

صيغة مستقرة ويمكن توقعها.

كل حدث يُسلَّم في غلاف متطابق: معرّف فريد لإزالة التكرار، طابع زمني، نوع الحدث، وكتلة data خاصة بالمجال. رأس X-Signature HMAC للتحقق من الأصالة.

  • ✓إعادة محاولة أُسية في 5 محاولات على 24 ساعة إذا أجاب endpoint بـ >= 500.
  • ✓سجل التسليمات قابل للاستشارة في لوحة التحكم، إعادة التشغيل ممكنة.
  • ✓Wildcards: اشترك في booking.* أو حتى * لالتقاط كل شيء.
  • ✓اختبار من الواجهة : زر « اختبار » يرسل payload تجريبي إلى endpoint الخاص بك.
POST your-endpoint · payload 
{
  "id": "7f2a8b1c-9d4e-4f5a-b2c1-...",
  "event": "booking.confirmed",
  "created_at": "2026-07-15T10:23:41+00:00",
  "agency_id": 42,
  "data": {
    "booking": {
      "id": 9876,
      "reference": "BKG-A1B2C3",
      "status": "confirmed",
      "source": "airbnb",
      "check_in": "2026-08-12",
      "check_out": "2026-08-19",
      "guests_count": 2,
      "guest_name": "Karim B."
    }
  }
}
نطاقات API · 21 أذونات

تذاكر بنطاق أدنى.

كل تذكرة محدودة بمجموعة فرعية من الصلاحيات — مبدأ الامتياز الأدنى. تذكرة Metabase لديها فقط reports:read، تذكرة Zapier للإنتاج لديها فقط bookings:write.

properties:read قراءة العقارات
properties:write تعديل مصادر iCal وإطلاق مزامنة
bookings:read قراءة الحجوزات
bookings:write إنشاء وإلغاء الحجوزات
owners:read قراءة الملاك
invoices:read قراءة الفواتير
calendar:read قراءة التقويم
rates:read قراءة التسعيرات الموسمية
rates:write إنشاء وتعديل وحذف التسعيرات الموسمية
cleaning:read قراءة مهام التنظيف
cleaning:write إنشاء وإدارة مهام التنظيف
maintenance:read قراءة تذاكر الصيانة
maintenance:write إنشاء وإدارة تذاكر الصيانة
whatsapp:read قراءة رسائل واتساب في الـ outbox
whatsapp:write تحضير رسائل واتساب بقالب
reports:read قراءة التقارير المجمعة (occupancy، revenue، ADR، RevPAR)
statements:read قراءة كشوف الملاك (payouts شهرية)
audit:read قراءة سجل التدقيق (قانون 09-08 / SIEM)
reviews:read قراءة تقييمات الضيوف (إدارة السمعة)
reviews:write إنشاء تقييمات الضيوف (استيراد OTA / يدوي)
tax_reports:read site.api_ability_tax_reports:read
أسئلة المطورين

أسئلة شائعة.

هل API مُضمَّن في جميع الخطط؟ +
لا. واجهة REST مخصصة لخطط Business و Pro. خطة Basic لها وصول فقط إلى API قراءة فواتير SaaS (المحاسبة).
هل هناك حد للطلبات؟ +
نعم: 60 طلبًا/دقيقة لكل تذكرة. رؤوس X-RateLimit-* القياسية تُرجَع في كل استجابة لتسهيل التراجع من جهة العميل.
هل الـ webhooks آمنة؟ +
كل payload موقع بـ HMAC-SHA256 بسر فريد لكل webhook (رأس X-Signature). يمكنك التحقق من الأصالة قبل المعالجة.
ماذا يحدث إذا سقط endpoint webhook الخاص بي؟ +
يعيد النظام المحاولة 5 مرات على 24 ساعة بتراجع أُسي. التسليمات الفاشلة قابلة للاستشارة في لوحة التحكم، مع زر « إعادة » متاح لمدة 7 أيام.
هل أستطيع الاختبار دون التعاقد؟ +
نعم — التجربة المجانية لـ Business لمدة 14 يومًا تمنح الوصول إلى كل API. يمكنك توليد تذكرة والاختبار دون التزام.
هل تدعم API لغة GraphQL؟ +
لا، إنها واجهة REST JSON، موثقة بـ OpenAPI 3. GraphQL غير مخطط — معظم التكاملات المستهدفة (Zapier، Make، n8n) REST-first.

هل أنت مستعد لربط مجموعتك التقنية؟

14 يومًا تجربة مجانية لخطة Business. لا بطاقة مطلوبة. تولّد أول تذاكرك في دقيقتين.

ابدأ التجربة المجانية عرض الأسعار