ستجد هنا كل ماتحتاجه لمساعدتك في فهم واجهات واثق البرمجية (API)
ابتداءً من التسجيل وإلى إرسال استعلامك الأول
بعد إكمال نموذج التسجيل الموجود في صفحة التسجيل، سيصلك رابط التحقق على بريدك الإلكتروني وسيتم تفعيل حسابك من خلال الرابط المرسل، بعدها ستتمكن من تطوير تطبيقك الأول
قم بتسجيل الدخول لإضافة تطبيقك الاول.بعد تسجيل الدخول ستتمكن من إضافة تطبيقك وتحديد منتجات البيانات المطلوبة
يمكنك الآن الوصول إلى تطبيقاتك من خلال صفحة تطبيقاتي.
*يمكنك إضافة تطبيق واحد فقط للباقة التجريبية.
*في هذه الخطوة يستحسن الاستعانة بالمطور التقني الخاص بك لإكمال الخطوات القادمة
ستتمكن من استعراض التطبيق عبر الضغط على "استعرض" وتستطيع الحصول على مفتاح الآمان الخاص بتطبيقك
*يرجى المحافظة على سرية مفتاح الأمان وكلمة السر الخاصة بتطبيقك
أنت الآن جاهز لتنفيذ استعلامك الأول
بعد حصولك على الــ 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