مفاتيح API وAPI
اسمح لنظام آخر بقراءة وكتابة بيانات IDup الخاصة بك تحت مفتاح يمكنك تجديده أو حذفه، واعثر على دليل API.
مفتاح API هو كلمة مرور تنتمي إلى برنامج بدلاً من شخص. تعامل معه بنفس الطريقة: أصدر واحدًا لكل نظام، واستبدله عندما يتغير ذلك النظام.
إنشاء مفتاح
- فتح API → إدارة API واضغط مفتاح جديد.
- امنحه اسمًا يوضح النظام الذي يستخدمه.
- اختر أذونات: وصول كامل، أو فقط المناطق التي يحتاجها النظام. معظم المناطق تميز بين القراءة، الإنشاء والتغيير.
- اختر تاريخ انتهاء، أو لا تختار.
- استخدام عرض و نسخ على بطاقة المفتاح لتسليم المفتاح إلى النظام المتصل. يرسله النظام في authtoken رأس.
تظهر كل بطاقة مفتاح الأذونات وتاريخ الإنشاء، آخر استخدام وشارة مثل "نشط" أو "ينتهي في 5 أيام".
تجديد المفتاح قبل انتهاء صلاحيته
أربعة عشر يومًا قبل انتهاء صلاحية المفتاح، تحصل على إشعار واحد في الجرس. اضغط تجديد على بطاقة المفتاح واختر تاريخ الانتهاء الجديد. يقوم IDup بإنشاء مفتاح جديد بنفس الأذونات. انسخه فورًا، لأن هذا العرض يظهر مرة واحدة فقط. يبقى المفتاح القديم صالحًا حتى انتهاء صلاحيته، لذا يمكنك تبديل النظام دون فجوة.
المناطق التي يمكنك الوصول إليها
تشمل واجهة برمجة التطبيقات بيانات عملائك، وبناءً على خطتك، العقارات والإيجارات، ملفات البحث، ملفات الضرائب، ملفات الوكيل، المحاسبة، تشغيل الرواتب ومسح الإيصالات. يحتوي AI Studio وصندوق البريد على مجالاتهما الخاصة. يسرد دليل واجهة برمجة التطبيقات فقط المجالات التي تتضمنها خطتك.
دليل واجهة برمجة التطبيقات
افتح التوثيق علامة التبويب في صفحة إدارة API، أو API → دليل API. كل منطقة تعرض حقولها، أمثلة على الطلبات التي يمكنك نسخها، أمثلة على الإجابات وأكواد الأخطاء.
الويب هوك وواجهات أخرى
- ال الويب هوك علامة التبويب ترسل الأحداث إلى نظامك عند حدوثها — انظر إرسال الأحداث إلى نظامك الخاص باستخدام webhooks.
- إذا تم تشغيل واجهة برمجة التطبيقات للعميل، فإن إعدادات API للعملاء علامة التبويب تفتح إعداداتها، على سبيل المثال ما إذا كان يمكن للعملاء التسجيل عبر API.
- الأتمتة / سير العمل → الواجهة التقنية يصدر رمزًا لواجهة GraphQL.
- AI Studio → مفاتيح API الشخصية هو مجموعة منفصلة من المفاتيح.
الحفاظ على الأمان
- مفتاح واحد لكل نظام، لا يوجد مفتاح مشترك.
- أعطِ المفتاح فقط الأذونات التي يحتاجها النظام.
- تعيين تاريخ انتهاء وتجديد وفق جدول زمني.
- احذف مفتاحًا بمجرد مغادرة شخص يعرفه، أو عند إيقاف تشغيل النظام.
لا يتم تتبع أي شيء — الأزرار تفتح فقط رسالة لتخبرنا بما كان مفقودًا.

