Sorry, you need to enable JavaScript to visit this website.

خطوات البدء

دليل البدء السريع

ستجد هنا كل ماتحتاجه لمساعدتك في فهم واجهات واثق البرمجية (API) 
  ابتداءً من التسجيل وإلى إرسال استعلامك الأول

الخطوة 1: إنشاء حساب

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

الخطوة 2: إضافة تطبيق

قم بتسجيل الدخول لإضافة تطبيقك الاول.بعد تسجيل الدخول ستتمكن من إضافة تطبيقك وتحديد منتجات البيانات المطلوبة 

  1. تسجيل الدخول إلى"خدمة واثق"
  2. الضغط على "تطبيقاتي"
  3. الضغط على "إضافة تطبيق جديد"
  4. كتابة اسم التطبيق (يكون من اختيارك مثل "My Test App")
  5. تحديد المنتجات المطلوبة 
  6. تحديد "إضافة تطبيق" لإكمال تسجيل التطبيق الخاص بك 

يمكنك الآن الوصول إلى تطبيقاتك من خلال صفحة تطبيقاتي.

*يمكنك إضافة تطبيق واحد فقط للباقة التجريبية.

الخطوة 3: الحصول على مفتاح الأمان للتطبيق

*في هذه الخطوة يستحسن الاستعانة بالمطور التقني الخاص بك لإكمال الخطوات القادمة


ستتمكن من استعراض التطبيق عبر الضغط على "استعرض" وتستطيع الحصول على مفتاح الآمان الخاص بتطبيقك


*يرجى المحافظة على سرية مفتاح الأمان وكلمة السر الخاصة بتطبيقك
 

الخطوة 4: البدء بالربط

أنت الآن جاهز لتنفيذ استعلامك الأول


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

مثال على أحد الخيارات المتاحة لكيفية تنفيذ استعلامك الأول
 

curl -X GET "https://api.wathq.sa/v4/commercialregistration/info/1010XXXXXX" \
-H "accept: application/json" \
-H "apiKey: YOURAPIKEY

1010XXXXXX - تمثل رقم السجل التجاري أو رقم الكيان المبتدأ ب 7 المراد الاستعلام عنه.

YOURAPIKEY - تمثل مفتاح الأمان الخاص بتطبيقك

 

العينة التالية تمثل الرد على الاستعلام السابق في حال نجاح الاستعلام http status = 200

{
  "cr_info": {
    "cr_name": "اسم السجل التجاري",
    "cr_number": 1010XXXXXX,
    "cr_entity_no": 7015XXXXXX,
    "cr_issue_date": "1440/10/29",
    "cr_expiry_date": "1441/10/29",
    "cr_main_number": null,
    "cr_bus_type": {
      "id": "101",
      "name": "مؤســـسة فـــردية"
    },
    "cr_fiscal": {
      "month": 10,
      "day": 28,
      "calendar_type": {
        "id": 1,
        "calendar_type": "هجري"
      }
    },
    "cr_status": {
      "id": "active",
      "name": "السجل التجاري قائم",
      "name_en": "السجل التجاري قائم"
    },
    "cr_cancellation": null,
    "cr_location": {
      "id": "1010",
      "name": " الرياض"
    },
    "cr_company": null,
    "cr_activities": {
      "description": "أعمال ورش النجارة بشكل عام،صناعة المباني الخشبية سابقة التجهيز،أنشطة أخرى خاصة بانتاج وصناعة منتجات النجارة المستخدمة في البناء والتشييد",
      "isic": [
        {
          "id": "162250",
          "name": "أعمال ورش النجارة بشكل عام",
          "name_en": "Carpentry works"
        },
        {
          "id": "162270",
          "name": "صناعة المباني الخشبية سابقة التجهيز",
          "name_en": "Manufacture of prefabricated wooden buildings"
        },
        {
          "id": "162290",
          "name": "أنشطة أخرى خاصة بانتاج وصناعة منتجات النجارة المستخدمة في البناء والتشييد",
          "name_en": "Other activities of production and manufacture of carpentry products used in construction"
        }
      ]
    }
  }
}

 

جميع الاستعلامات سواء الناجحة أو الفاشلة يوجد لها رقم مرجعي خاص بها لغرض استخدامه عند وجود أي استفسار مع فريق دعم واثق. بالإمكان الحصول على الرقم المرجعي من الرد المستلم من خدمة Response header .  تستطيع دوماً الحصول على الرقم المرجعي المسمى ب THIQAH-API-ApiMsgRef  كما في العينة التالية :

THIQAH-API-ApiMsgRef →6c7d7d44-b1f8-4b1a-8db1-4dbca3370f57