ابدأ من سير العمل، لا من عدد نقاط النهاية.
أخبرنا بالأنظمة وسجلات الإيجار التي تحتاج إلى الانتقال. نؤكد النطاق المدعوم وقواعد الوصول وتدفق الأحداث قبل الإطلاق.
أبقِ السجلات المدعومة متوافقة
اقرأ سجلات سير عمل التأجير المعتمدة دون فتح الوصول إلى بقية مساحة عملك.
عائلات البيانات في العقد الحالي
- Deals
- Properties
- Contacts
تفاعل مع التغييرات المهمة
استخدم الويب هوك الموقّعة لتغييرات الصفقات والمدفوعات والمستندات والأطراف والمهام والامتثال المدعومة.
عائلات الأحداث
- compliance
- deal
- document
- party
- payment
- task
تحكّم في كل مفتاح
حُدّ كل مفتاح بالصلاحيات ونقاط النهاية وقائمة عناوين IP الاختيارية، ثم ألغِه أو حدّد له تاريخ انتهاء عند الحاجة.
اطّلع على ما حدث
راجع سجل استخدام الواجهة البرمجية وتاريخ تسليم الويب هوك عند مراقبة التكامل أو معالجة خلل فيه.
كيف يُمنح وصول التكامل في خطة Enterprise
- 1
أكّد النطاق المدعوم
شارك الأنظمة والسجلات والإجراءات التي يحتاجها تكاملك. نؤكد ما ينتمي إلى العقد الخارجي المعتمد.
- 2
أنشئ مفتاح شركة محدودًا
ينشئ مسؤول الوكالة مفتاح شركة للقراءة فقط، بنقاط النهاية المعتمدة وتاريخ انتهاء وقائمة عناوين IP اختيارية.
- 3
اتصل وراقب
وثّق كل طلب بمفتاح الواجهة البرمجية، وتحقّق من تواقيع الويب هوك، واستخدم السجلات المتاحة لمراقبة الاتصال.
تحكّم في الحدود
امنح كل تكامل الوصول الذي يحتاجه فقط.
عزل الشركة، والوصول للقراءة فقط، وقوائم نقاط النهاية المسموح بها، وتواريخ الانتهاء، وقيود IP الاختيارية — كلها تُبقي كل تكامل داخل نطاقه المعتمد.
- محصور بالشركة
- وصول للقراءة فقط
- قائمة نقاط النهاية
- قائمة IP اختيارية
- انتهاء الصلاحية والإلغاء
استخدم الواجهة البرمجية للسجلات، والويب هوك للتغييرات.
الواجهة البرمجية الخارجية
اقرأ السجلات المدعومة المتاحة لتكاملك. تتم المصادقة بمفتاح الشركة عبر HTTPS.
ويب هوك موقّعة
استقبل التغييرات المدعومة دون استطلاع متكرر. تتضمن كل عملية تسليم معرّف حدث وطابعًا زمنيًا وتوقيع HMAC-SHA256 للتحقق.
يساعد تاريخ التسليم وإعادة المحاولة فريقك على تقصّي استدعاءات الويب هوك الفاشلة.
ابنِ وفق عقد تكامل معتمد.
أثناء الإطلاق، يتسلّم فريقك التقني نطاق الموارد والأحداث المعتمد، ومتطلبات المصادقة، وسلوك الأخطاء، والحدود، وإرشادات التحقق من الويب هوك لذلك التكامل.
نطاق الواجهة البرمجية المعتمد
ترى فقط الموارد والأساليب المؤكدة لتكامل وكالتك.
المصادقة والحدود
تتسلّم متطلبات مفتاح الشركة والصلاحيات وسلوك الأخطاء والحدود المطبّقة عند الإطلاق.
التحقق من الويب هوك
اضبط عنوان استقبال معتمدًا، وتحقّق من الحمولات الموقّعة، وافهم سلوك التسليم وإعادة المحاولة.
الأسئلة الشائعة
- هل وصول الواجهة البرمجية مشمول في الخطط ذاتية الاشتراك؟
- مفاتيح الواجهة البرمجية والويب هوك من قدرات خطة Enterprise. تواصل مع المبيعات موضحًا الأنظمة وسير العمل الذي تحتاجه ليُؤكَّد النطاق المدعوم قبل الإطلاق.
- كيف يجري التكامل عملية المصادقة؟
- ينشئ مسؤول الوكالة مفتاح واجهة برمجية محصورًا بالشركة. يرسل التكامل ذلك المفتاح في ترويسة طلب HTTPS الموثّقة؛ ولا يجري استبداله برمز JWT للمستخدم.
- هل يمكننا تقييد ما يصل إليه مفتاح الواجهة البرمجية؟
- نعم. يمكن تقييد المفاتيح بالصلاحيات ونقاط النهاية المعتمدة وتاريخ الانتهاء وقائمة عناوين IP اختيارية، ثم إلغاؤها عند انتفاء الحاجة إليها.
- أي السجلات يمكننا ربطها؟
- تعتمد الموارد المتاحة على العقد الخارجي المؤكد لإطلاقك. يسرد التسليم التقني الموارد والأساليب المعتمدة لتكامل وكالتك فقط.
- كيف تُحمى استدعاءات الويب هوك؟
- يرسل TenancyDesk الأحداث المدعومة إلى عناوين HTTPS بتوقيع HMAC-SHA256 مصحوب بطابع زمني. ويتحقق تكاملك من التوقيع قبل معالجة الحمولة.
- هل تحل الواجهة البرمجية محل استيراد Property Finder أو Bayut؟
- لا. يعمل Property Finder ببيانات اعتماد الواجهة البرمجية الخاصة بوكالتك، بينما يستخدم Bayut / dubizzle استيراد ملف Excel من Profolio. أما واجهة Enterprise البرمجية فمخصصة للاتصالات المعتمدة بأنظمتك الداخلية. راجع صفحة التكاملات لمعرفة طريقة الاتصال لكل منصة.
- هل يمكننا اختبار الواجهة البرمجية خلال الفترة المجانية المعتادة؟
- تغطي فترة الـ 14 يومًا تجربة منتج خطة Professional. أما مفاتيح الواجهة البرمجية والويب هوك فيُتفق على نطاقها بشكل منفصل مع مبيعات Enterprise.
خطّط للتكامل حول سير عملك الفعلي.
أخبرنا بالأنظمة والسجلات التي تحتاج إلى الانتقال. سنؤكد النطاق المدعوم وأدوات التحكم ومسار الإطلاق.