انتقل إلى المحتوى
ابدأ مجانًا
المطوّروننظرة سريعة

Memlira Connect

عقد قراءة صغير يقدّمه نظامك، فيزامن Memlira بياناته. لا مكتبة تثبّتها، ولا كتابة على نظامك.

الإصدار v0. المصادقة Authorization: Bearer <key> بمفتاح قراءة فقط يصدره نظامك. JSON بـ snake_case، وتواريخ ISO 8601 مع المنطقة الزمنية. المطلوب بالحد الأدنى: manifest وكيان واحد.

manifest

أول ما نطلبه: ماذا يقدّم نظامك. نقرأ منه الكيانات والحقول ونطابقها مع مخطط Memlira.

JSON
// GET /memlira/v0/manifest
{
  "version": "0",
  "system": "Northwind ERP",
  "currency": "SAR",
  "timezone": "Asia/Riyadh",
  "entities": ["customers", "orders", "order_items", "invoices"],
  "stages": [{"entity": "order_items", "values": ["cutting", "stitching", "assembly", "lasting", "pressing", "warehouse", "export"]}],
  "custom_fields": [{"entity": "orders", "key": "model_no", "type": "text", "label": "رقم الموديل"}]
}

الكيانات: customers، items، orders، order_items، invoices، payments، shipments، bookings، stock_levels.

نقاط النهاية

GET/memlira/v0/manifestالكيانات المتوفرة، والحقول الخاصة، ومراحل التشغيل، والعملة والمنطقة الزمنية
GET/memlira/v0/{entity}?updated_since=…&cursor=…&limit=500سجلات الكيان مرتبة بـ updated_at، مع next_cursor
GET/memlira/v0/deleted?since=…المحذوفات، أو "deleted": true داخل السجل

الشروط الإجبارية

بدون هذه الشروط تخطئ المزامنة التزايدية بصمت.
  1. updated_at موثوق لكل سجل: يتغيّر مع أي تعديل على السجل أو بنوده، ومع المنطقة الزمنية.
  2. ترتيب ثابت للصفحات: ORDER BY updated_at, external_id، وnext_cursor مبني على الاثنين، فلا يضيع سجلان لهما نفس updated_at بين صفحتين.
  3. المحذوفات: سجل فيه "deleted": true، أو GET /memlira/v0/deleted?since=…. والنظام الذي لا يحذف أبدًا يعلن ذلك في الـ manifest بـ "deletes": "none".
  4. updated_since شامل (>=). التكرار نعالجه عندنا.
JSON
// GET /memlira/v0/orders?updated_since=…  (deleted record)
{
  "external_id": "21852",
  "deleted": true,
  "updated_at": "2026-10-14T13:40:00+03:00"
}

ونجري مزامنة كاملة كل ليلة تصحّح أي فرق، وتعلّم السجلات التي اختفت كمحذوفة. الأخطاء بأكواد HTTP القياسية، ونحترم Retry-After مع 429.

الاختبار

من لوحة Memlira: «اختبر الاتصال» يطلب الـ manifest وأول صفحة من كل كيان، ويتحقق من المفتاح، ويعرض لك ما وجده قبل أي مزامنة.