# واجهة برمجة التطبيقات لمنصة تندرز اليرتس الداعمة لمنصة منافسات اعتماد

## توثيق واجهة برمجة التطبيقات لتندرز اليرتس

تُعد **واجهة برمجة التطبيقات (API)** الخاصة بمنصة [tendersalerts.com](https://tendersalerts.com) من المكونات الأساسية التي تمكّنك من الوصول إلى [المناقصات الحكومية في السعودية](https://tendersalerts.com) التي يتم جمعها من منصة اعتماد. تمثل هذه الوثائق دليلاً شاملاً للمطورين الراغبين في دمج البيانات في أنظمتهم أو تطبيقاتهم.

---

## استخدام واجهة برمجة التطبيقات

<Card>

- **الوصول إلى بيانات المناقصات**: استخدم نقطة النهاية `/tenders` للحصول على تفاصيل المناقصات، بما في ذلك المواعيد النهائية، والحالات، والجهات المُصدرة، مع إمكانيات متقدمة للتصفية والترتيب.  
<Icon icon="material-outline-label"/> [عرض قائمة المناقصات.](https://docs.tendersalerts.com/retrieve-a-list-of-tenders-12818631e0.md)

- **الحصول على بيانات التصفية**: توفر نقطة النهاية `/filters` قوائم بالمدن والمناطق وغيرها، يمكن استخدامها كخيارات لتصفية البحث.  
<Icon icon="material-outline-label"/> [عرض بيانات التصفية حسب النموذج.](https://docs.tendersalerts.com/retrieve-filterable-data-by-model-12815014e0.md)

- **فحص حالة النظام**: استخدم نقطة النهاية `/live` للتحقق من أن النظام يعمل بشكل سليم وجاهز للتكامل.  
<Icon icon="material-outline-label"/> [تحقق من حالة النظام.](https://docs.tendersalerts.com/check-if-the-api-is-live-12818885e0.md)

- **التحقق من الحساب**: يمكنك من خلال `/account` استرجاع معلومات الحساب والتحقق من حالة المصادقة.  
<Icon icon="material-outline-label"/> [استرجاع معلومات الحساب.](https://docs.tendersalerts.com/retrieve-account-details-12818888e0.md)

</Card>

---

## البدء

لبدء استخدام الواجهة، قم بالتسجيل في [tendersalerts.com](https://tendersalerts.com) للحصول على مفتاح API.

<Card title="تسجيل حساب جديد" href="https://tendersalerts.com/register">
  قم بالتسجيل في [tendersalerts.com](https://tendersalerts.com) ثم تواصل معنا عبر [الواتساب من هنا](https://wa.me/971585350399) للحصول على مفتاح API إذا لم يكن لديك.
</Card>

---

## مزايا استخدام الواجهة

<CardGroup cols={2}>
  <Card title="الوصول الفوري للبيانات">
    احصل على أحدث المناقصات الحكومية مباشرة من منصة اعتماد مع تحديثات يومية دقيقة.
  </Card>
  <Card title="تصفية متقدمة">
    صَفّ المناقصات حسب المنطقة أو المدينة أو الجهة أو الحالة أو التاريخ وغير ذلك.
  </Card>
  <Card title="تكامل سهل وسريع">
    نقاط نهاية REST بسيطة وآمنة جاهزة للدمج مع أي نظام أو لوحة بيانات أو CRM.
  </Card>
  <Card title="موثوقية واستقرار عالي">
    بنية تحتية موثوقة مع نقاط تحقق من الحالة لضمان أقل وقت توقف ممكن.
  </Card>
</CardGroup>

---

## حالات استخدام شائعة

<CardGroup cols={2}>
  <Card title="أنظمة المشتريات وERP">
    دمج بيانات المناقصات في أنظمة الـ ERP والمشتريات الداخلية لتتبع الفرص مباشرة.
  </Card>
  <Card title="إثراء بيانات الـ CRM">
    دمج بيانات المناقصات مع النظام لإعطاء فريق المبيعات رؤى حول العملاء المرتبطين بمناقصات حالية أو سابقة.
  </Card>
  <Card title="أدوات التحليل والسوق">
    أنشئ لوحات تحكم ذكية وتحليلات تعتمد على بيانات المناقصات لتتبع توجهات السوق.
  </Card>
  <Card title="أنظمة الإشعارات الذكية">
    أنشئ بوتات Slack أو WhatsApp أو بريد إلكتروني تُبلغ فريقك فور توفر مناقصة جديدة.
  </Card>
</CardGroup>

---

## أنظمة التكامل المدعومة

يمكنك دمج واجهة API الخاصة بنا بسهولة مع العديد من الأدوات والخدمات:

<CardGroup cols={2}>
  <Card title="Zapier">
    أتمتة سير العمل من خلال Zapier لربط tendersalerts.com مع أكثر من 5000 تطبيق.
    <br/>
    <Icon icon="material-outline-check_circle"/> أتمتة بدون كود لإشعارات المناقصات أو تحديثات CRM.
  </Card>
  <Card title="Make (Integromat)">
    استخدم Make لإنشاء سيناريوهات متقدمة يتم فيها تشغيل العمليات بناءً على بيانات المناقصات.
    <br/>
    <Icon icon="material-outline-check_circle"/> مثالي للشركات الصغيرة والمتوسطة.
  </Card>
  <Card title="Salesforce وHubSpot">
    دمج بيانات المناقصات مباشرة في أنظمة CRM لتحديث الصفقات والعملاء.
    <br/>
    <Icon icon="material-outline-check_circle"/> دعم لتكوينات مخصصة ومرنة.
  </Card>
  <Card title="التطبيقات الخلفية المخصصة">
    يمكن للمطورين استخدام REST API مباشرة مع Laravel، Node.js، Django، وغيرها.
    <br/>
    <Icon icon="material-outline-check_circle"/> مرونة كاملة وتحكم مطلق.
  </Card>
</CardGroup>


---
## كراسة الشروط وجداول الكميات


<CardGroup cols={2}>
  <Card title="الوصول إلى وثائق كراسة الشروط (TSD)">
    أصبح بإمكانك الآن الحصول على **كراسة الشروط الرسمية (TSD)** من خلال رابط موقع (Signed URL).  
    <Icon icon="material-outline-description"/> يتيح ذلك الوصول الآمن برمجيًا للوثائق الأصلية لتنزيلها أو معالجتها.
  </Card>
  <Card title="جداول الكميات">
    توفر الواجهة الآن **جداول الكميات** كصفوف متداخلة (Nested Arrays) منظمة.  
    <Icon icon="material-outline-table_chart"/> مما يسهل تحليلها وربطها مباشرة مع أنظمة المشتريات أو التحليل لديك.
  </Card>
  <Card title="معلومات التواصل مع الجهة المصدرة">
    كل مناقصة تتضمن الآن **معلومات الاتصال** الخاصة بالشخص المسؤول في الجهة الحكومية المصدرة.  
    <Icon icon="material-outline-contact_phone"/> مما يسمح بالتواصل المباشر والاستفسار بسهولة أكبر.
  </Card>
</CardGroup>

---

## الدعم والتواصل

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

<CardGroup cols={2}>
  <Card title="مجموعة الدعم الفني" href="https://wa.me/971585350399">
    <Icon icon="material-outline-support"/> تواصل معنا مباشرة عبر الواتساب.
  </Card>
  <Card title="المساعدة عبر البريد الإلكتروني" href="mailto:support@tendersalerts.com">
    <Icon icon="material-outline-description"/> راسلنا لطلب توضيح تقني أو مساعدة في نقاط النهاية.
  </Card>
</CardGroup>

---

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