خطوات البدء

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

قم بإنشاء حساب مطور عبر البوابة. بمجرد التحقق من عنوان بريدك الإلكتروني ، ستتمكن من تطوير تطبيقك الأول.

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

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

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

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

  • يرجى المحافظة على مفتاح الآمان و كلمة السر الخاص بتطبيقك في مكان آمن دوماً.

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

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

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

 

اشترك معنا للحصول على آخر تحديثات واثق