في الإعدادات › الوصول عبر API، يمكنك إنشاء رموز وصول شخصية ليتمكن برنامج نصي أو عميل MCP من استخدام Dvina باسمك. ويمكن للمسؤولين أيضًا إضافة خطافات ويب من هناك لإرسال أحداث Livespace إلى أنظمتهم.
يتوفر الوصول عبر API ضمن خطة Enterprise. يمكن لكل عضو إنشاء رموزه الخاصة؛ ولا يظهر قسم خطافات الويب إلا للمالكين والمسؤولين.
إنشاء رمز وصول
- افتح الإعدادات واختر الوصول عبر API.
- ضمن رموز الوصول الشخصية، اختر إنشاء رمز وصول.
- أدخل اسمًا لتعرف لاحقًا ما الذي يستخدمه.
- اختر صلاحية الوصول: القراءة فقط أو القراءة والكتابة.
- اختر موعد انتهاء الصلاحية: بعد 30 يومًا أو بعد 90 يومًا أو بعد 365 يومًا أو لا تنتهي الصلاحية.
- اختر إنشاء رمز وصول.
- ضمن نسخ رمز الوصول، انسخ الرمز واحفظه في مكان آمن. لن يظهر إلا هذه المرة.
يعمل رمز الوصول باسمك، في Livespace الذي أنشأته فيه، وبصلاحيات دورك الحالي هناك. يتيح رمز القراءة فقط قراءة المحتوى، لكنه لا يتيح إضافة أي شيء أو تغييره.
لاستخدام رمز وصول مع عميل MCP، راجع الاتصال باستخدام مفتاح API بدلًا من OAuth.
مراجعة رمز وصول أو تدويره أو إلغاؤه
تُدرج رموزك ضمن رموز الوصول الشخصية مع صلاحية الوصول لكل منها. اختر رمزًا للاطلاع على بدايته وصلاحية الوصول ووقت آخر استخدام وموعد انتهاء الصلاحية.
- لاستبدال رمز وصول، اختر تدوير…، ثم تدوير للتأكيد. يحل رمز جديد محله، ويتوقف الرمز القديم عن العمل فورًا. انسخ الرمز الجديد ضمن نسخ رمز الوصول.
- لإيقاف رمز وصول، اختر إلغاء…، ثم إلغاء للتأكيد. يتوقف كل ما يستخدمه عن العمل فورًا.
يُسجَّل إنشاء رموز الوصول وتدويرها وإلغاؤها في سجل التدقيق.
إضافة خطاف ويب
يرسل خطاف الويب أحداث Livespace، وهي السجلات نفسها الواردة في سجل التدقيق، إلى عنوان تختاره.
- في الإعدادات › الوصول عبر API، ضمن خطافات الويب، اختر إضافة خطاف ويب.
- أدخل اسمًا وعنوان URL. استخدم عنوان HTTPS متاحًا للعامة.
- ضمن الأحداث، اترك الحقل فارغًا لإرسال جميع الأحداث، أو أدرج الإجراءات والمجالات، مثل
member.addedأوsharing.*. - اختر إضافة.
- ضمن نسخ سر التوقيع، انسخ السر. لن يظهر إلا هذه المرة.
إذا عرض Dvina رسالة لا يمكن الوصول إلى هذا العنوان من Dvina، فاستخدم عنوان HTTPS متاحًا للعامة.
التحقق من توقيع كل طلب
يرسل Dvina الأحداث على دفعات بتنسيق JSON، ويوقّع كل طلب. استخدم سر التوقيع للتحقق من أن الطلب جاء من Dvina:
- يحتوي كل طلب على ترويسة
X-Dvina-Signatureبصيغة مثلt=<timestamp>,v1=<signature>. - التوقيع هو قيمة HMAC-SHA256 بالنظام الست عشري، تُنشأ باستخدام سر التوقيع من الطابع الزمني، ثم نقطة، ثم محتوى الطلب.
- احسب التوقيع بنفسك وقارنه بالتوقيع المُرسل. ارفض أي طلب لا يتطابق توقيعه أو يكون طابعه الزمني قديمًا جدًا.
التحقق من خطاف ويب أو تغييره
تظهر خطافات الويب ضمن خطافات الويب مع حالتها: مفعّل أو متوقف مؤقتًا أو متعثر. اختر أحدها للاطلاع على تفاصيله.
- لتغييره، عدّل الاسم أو عنوان URL أو الأحداث، ثم اختر حفظ.
- لإيقافه مؤقتًا، أوقف تشغيل إرسال الأحداث. أعد تشغيله لاستئناف الإرسال.
- لمتابعة أدائه، تحقق من الحالة وعدد الأحداث التي أُرسلت. يعرض خطاف الويب المتعثر آخر خطأ. يواصل Dvina المحاولة ويسجّل الفشل في سجل التدقيق.
- لتغيير سرّه، اختر سر توقيع جديد…، ثم أكّد. تُوقَّع الطلبات بالسر الجديد فورًا، لذا حدّث الجهة المستقبِلة على الفور.
- لإزالته، اختر حذف…، ثم حذف للتأكيد. لن يُرسَل إليه أي شيء بعد ذلك.