كيف تستفيد منصات البروبتك السعودية من واجهات واثق البرمجية

قطاع التقنية العقارية (البروبتك) في المملكة يشهد نمواً متسارعاً، مدفوعاً برؤية 2030 ومبادرات الهيئة العامة للعقار. لكن التحدي الأكبر الذي يواجه كل مطوّر يبني منصة عقارية هو: كيف أحصل على بيانات موثوقة ومحدّثة من مصادرها الرسمية؟

الإجابة تكمن في واثق (Wathq) — المنصة الوطنية التي توفر واجهات برمجية (APIs) تربطك مباشرة بقواعد بيانات وزارة التجارة، وزارة العدل، والبريد السعودي. في هذا المقال، نستعرض كيف يمكن لمنصتك العقارية الاستفادة من هذه الواجهات عملياً.

ما هو واثق؟

واثق هو حل رقمي أطلقته شركة ثقة لخدمات الأعمال بالشراكة مع وزارة التجارة، يتيح للجهات المستفيدة التحقق المباشر من البيانات التجارية والعدلية عبر الربط الإلكتروني بتقنية API. تعالج المنصة أكثر من 20,000 عملية استعلام يومياً، وتدعم التسجيل والربط خلال 5 دقائق فقط.

ثلاث واجهات أساسية لمنصات البروبتك

من بين خدمات واثق المتعددة، هناك ثلاث واجهات تشكّل العمود الفقري لأي منصة تقنية عقارية:

حالات استخدام عملية في منصتك

1. التحقق الآلي من ملكية العقار

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

# الاستعلام عن صك عقاري عبر واثق
curl -X GET \
  "https://api.wathq.sa/v5/realestate/deed/{deedNumber}" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

الاستجابة تتضمن رقم الصك، نوع العقار، حالته، والمالك — مما يتيح لك بناء منطق تحقق آلي (Validation Logic) داخل منصتك.

2. التحقق من المنشآت العقارية (KYB)

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

• حالة السجل التجاري (ساري، منتهي، ملغى)
• نوع النشاط ومدى توافقه مع الأنشطة العقارية
• بيانات الملّاك والمدراء المعتمدين
• رأس المال المسجّل وتاريخ الإصدار

// التحقق من السجل التجاري لشركة عقارية
const verifyCompany = async (crNumber) => {
  const res = await fetch(
    `https://api.wathq.sa/v5/commercialregistration/info/${crNumber}`,
    {
      headers: {
        'apiKey': process.env.WATHQ_API_KEY,
        'Content-Type': 'application/json'
      }
    }
  );
  const data = await res.json();

  // التحقق من أن السجل ساري وأن النشاط عقاري
  return {
    isActive: data.status?.name === 'قائم',
    isRealEstate: data.activities?.some(
      a => a.description.includes('عقار')
    ),
    owners: data.parties
  };
};

3. تعبئة العنوان الوطني تلقائياً

عند إضافة عقار جديد أو التحقق من عنوان منشأة، واجهة العنوان الوطني من البريد السعودي تتيح لك استرجاع العنوان المهيكل (الحي، الشارع، الرمز البريدي، الرقم الإضافي) بشكل آلي، مما يقلل أخطاء الإدخال اليدوي ويضمن توحيد البيانات.

خطوات البدء مع واثق

بنية مقترحة: طبقة واثق في نظام البروبتك

لبناء تكامل متين وقابل للتوسع، ننصح بعزل استدعاءات واثق في طبقة خدمة مستقلة (Service Layer) بدلاً من استدعائها مباشرة من واجهة المستخدم:

┌──────────────────────────────────────────────┐
│          واجهة المستخدم (Frontend)           │
│     React / Next.js / Flutter                │
└──────────────────┬───────────────────────────┘
                   │
┌──────────────────▼───────────────────────────┐
│         طبقة الـ API Gateway                  │
│     Auth + Rate Limiting + Caching           │
└──────────────────┬───────────────────────────┘
                   │
┌──────────────────▼───────────────────────────┐
│         خدمة واثق (Wathq Service)             │
│  ┌─────────┐ ┌──────────┐ ┌──────────────┐  │
│  │ الصكوك  │ │ السجلات  │ │ العنوان      │  │
│  │ العقارية│ │ التجارية │ │ الوطني      │  │
│  └─────────┘ └──────────┘ └──────────────┘  │
└──────────────────┬───────────────────────────┘
                   │
┌──────────────────▼───────────────────────────┐
│           Wathq REST APIs                    │
│       api.wathq.sa/v5/...                    │
└──────────────────────────────────────────────┘

هذه البنية تمنحك عدة مزايا: التخزين المؤقت (Caching) لتقليل عدد الاستعلامات والتكلفة، التعامل المركزي مع الأخطاء، وسهولة إضافة خدمات واثق جديدة مستقبلاً دون تعديل الواجهة الأمامية.

هل تحتاج شريكاً تقنياً لبناء التكامل؟

ربط واجهات واثق بمنصة بروبتك ليس مجرد استدعاء API — الأمر يتطلب فهماً عميقاً لبنية البيانات الحكومية، وتصميم طبقات التحقق والأمان، وبناء تجربة مستخدم سلسة تخفي التعقيد التقني خلف واجهة بسيطة.

هنا يأتي دور واثب (LEAP RD&O).

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

جاهز لربط منصتك بواثق؟

فريق واثب يساعدك من التصميم إلى التشغيل — احجز جلسة استشارية مجانية مع فريقنا التقني.

احجز موعد استشاري شاهد أعمالنا