مركز المطوّرين هو المكان الذي تربط فيه Exayard ببرمجتك وأدواتك الخاصة. افتحه من الإعدادات ثم المطوّر. من هنا تنشئ مفاتيح API، وتسجّل نقاط نهاية خطافات الويب، وتراجع سجلاً مباشرًا لكل طلب API. ويمكن لمسؤولي المؤسسة وحدهم الوصول إلى هذه الصفحة.
مفاتيح API
يصادق مفتاح API الطلبات الموجّهة إلى واجهة Exayard البرمجية. وتنتمي المفاتيح إلى مؤسستك، لذا يُحدَّد الحساب الصحيح تلقائيًا ولا يوجد معرّف مؤسسة لتمريره.
افتح علامة التبويب مفاتيح API في بطاقة بيانات الاعتماد وانقر زر +. أعطِ المفتاح اسمًا، ثم اختر نطاقاته. اختر الكل لمنح كل نطاق، أو محدّد لاختيار أذونات فردية. تتبع النطاقات تقسيمًا للقراءة والكتابة لكل مورد، مثل read:projects وwrite:estimates. ونطاق admin:org هو منح وصول كامل. اختر الحد الأدنى من النطاقات التي يحتاجها تكاملك.
يُظهر Exayard المفتاح الكامل مرة واحدة، مباشرةً بعد إنشائه. انسخه حينها، لأنه لا يُعرض مرة أخرى أبدًا. وبعد ذلك، يظهر كل مفتاح باسمه ومعاينة مُقنَّعة مثل ak_••••1234 وتاريخ آخر استخدام له.
استخدم أيقونة القلم لإعادة تسمية مفتاح أو تغيير نطاقاته. واستخدم أيقونة سلة المهملات لـ إبطاله. والإبطال دائم وأي تكامل يستخدم ذلك المفتاح يتوقف عن العمل فورًا.
يصادق المفتاح نفسه التكاملات بدون برمجة. راجع ربط Exayard بـ Zapier وربط Exayard بـ Make وربط Exayard بـ n8n. وللوصول من الوكلاء ومحرّرات الذكاء الاصطناعي، راجع الاتصال بـ Claude وأدوات الذكاء الاصطناعي الأخرى.
خطافات الويب
يخبر خطاف الويب Exayard بإشعار خادمك عند حدوث شيء ما. افتح علامة التبويب خطافات الويب وانقر + لإضافة نقطة نهاية. أدخل عنوان URL الذي يجب أن يستقبل عمليات التسليم ووصفًا اختياريًا.
اختر الأحداث التي تريد الاشتراك فيها. اختر الكل لاستقبال كل حدث، أو محدّد للاختيار من القائمة:
الحدث | يُطلَق عند |
| إنشاء مشروع |
| تغيير مشروع |
| أرشفة مشروع |
| بدء تقييم حصر |
| اكتمال تقييم |
| اعتماد تقييم |
| إلغاء تقييم |
| إنشاء تقدير |
| إنشاء عطاء |
| انتهاء معالجة ملف مرفوع |
عند إنشاء نقطة نهاية، يُظهر Exayard سرّ توقيع مرة واحدة. انسخه حينها، لأنه لا يُعرض مرة أخرى.
تأمين عمليات تسليم خطافات الويب
تحمل كل عملية تسليم ترويسة Exayard-Signature بالصيغة t=<unix>,v1=<digest>. ويبني Exayard التوقيع بدمج الطابع الزمني وجسم الطلب، ثم يوقّعهما باستخدام HMAC-SHA256 مع سرّ نقطة النهاية الخاصة بك.
للتحقق من عملية تسليم، أعد حساب التوقيع باستخدام سرّك، وتأكد من أن الطابع الزمني ضمن خمس دقائق من الآن، وقارن الملخّصات. تُعاد محاولة عمليات التسليم الفاشلة بتراجع أُسّي على مدى ثلاثة أيام تقريبًا.
لتحرير نقطة نهاية، انقر أيقونة القلم. يمكنك تغيير عنوان URL والوصف والأحداث، وضبط حالتها على نشطة أو متوقفة مؤقتًا. وتتوقف نقاط النهاية المتوقفة مؤقتًا عن استقبال عمليات التسليم. ويحتوي مربع الحوار نفسه على زر تدوير السرّ. ويُصدِر التدوير سرًّا جديدًا ويتوقف القديم عن العمل فورًا، لذا حدّث خادمك قبل التدوير. وتحذف أيقونة سلة المهملات نقطة نهاية وتنهي كل عمليات التسليم إليها.
البدء السريع
تحتوي بطاقة البدء السريع على مطالبة جاهزة لمحرّر ذكاء اصطناعي مثل Claude أو Cursor. انقر نسخ المطالبة والصقها في محرّرك. وتتضمن المطالبة عنوان URL الأساسي لواجهة API وصيغة المصادقة ومفردات النطاقات ومخطط توقيع خطافات الويب، حتى يتمكن الذكاء الاصطناعي من إنشاء هيكل تكامل عامل ويسألك عن التفاصيل التي يحتاجها.
التوثيق
تربط بطاقة التوثيق بوثائق المطوّرين الكاملة ومواصفات OpenAPI، التي تصف كل مسار ومخطط. ويفتح الاتصال بـ MCP إعداد ربط وكلاء الذكاء الاصطناعي مباشرةً بـ Exayard.
السجلات
يسجّل قسم السجلات أحدث طلبات API لديك عبر كل من واجهة REST API و MCP. ويُظهر كل صف الطريقة والمسار وحالة الاستجابة وزمن الاستجابة. حدّد صفًا لرؤية تفاصيله الكاملة، بما في ذلك معرّف الطلب وأجسام الطلب والاستجابة. استخدم السجلات لتأكيد نجاح استدعاء أو لتصحيح تكامل فاشل.
