واجهة Sixto API: الإجراءات والصلاحيات نفسها التي يستخدمها فريقك
تتيح واجهة Sixto API الإجراءات نفسها المستخدمة في التطبيق، مثل المهام والسجلات والتقارير والرسائل، عبر مفاتيح لا تملك إلا النطاقات التي تمنحها لها. يُسجّل كل استدعاء في سجل نشاط المفتاح. يستطيع المفتاح التحقق من هويته وما يحق له فعله. تنتظر الإجراءات الحساسة تأكيد شخص.
متاح. تغطي واجهة REST API محددة الإصدار بمفاتيح محددة الصلاحيات الحجوزات والضيوف والمهام والشؤون المالية وتسجيل الوصول والأقفال والقنوات وغير ذلك.
أدواتك بوصول محدد
مفاتيح API لا تحصل إلا على الصلاحيات التي تختارها
ما الذي يقدمه
اعرف البيانات التي تنتقل وتلك التي تبقى في مكانها
توضح الأسهم اتجاه البيانات بالنسبة إلى Sixto.
تغطية واسعة
المهام والحجوزات والضيوف والمراجعات والرسائل وتسجيل الوصول والامتثال والأقفال والقنوات والفواتير الإلكترونية والبنك ودفتر الحسابات ومقارنات السوق والبحث والإعدادات.
مفاتيح محددة الصلاحيات من سجل واحد
تستمد المفاتيح صلاحياتها من السجل نفسه المستخدم للأشخاص. لتغيير الصلاحيات، ينشئ مالك مفتاحًا بديلًا ويلغي القديم. يسري الإلغاء على الاستدعاء التالي.
تصف نفسها
اسأل واجهة API عن هويتك وما يمكنك فعله (whoami وcapabilities)، بما في ذلك الصلاحيات المطلوبة لكل مسار.
إعادة محاولات آمنة وسجل نشاط
توضح كل عملية كتابة معرّف إعادة المحاولة، مثل external_id أو ترويسة Idempotency-Key، وتعيد 409 إذا أُعيد استخدام المعرّف نفسه بمحتوى مختلف. لكل طلب معرّف ويظهر في سجل النشاط.
حدود عادلة
لكل مفتاح حصته الخاصة، 600 طلب في الدقيقة افتراضيًا، حتى لا يبطئ مفتاح مشغول مفتاحًا آخر. يعرض GET /api/v1/capabilities القيمة الحالية.
تفضّل تطبيق ذكاء اصطناعي؟ استخدم MCP
إلى جانب واجهة REST API، يوفر Sixto خادم MCP لتطبيقات الذكاء الاصطناعي، مع تسجيل الدخول عبر OAuth، ويبقى معطلاً حتى يفعّله مالك المؤسسة أو مديرها. كما يوفر MCP عاماً للوثائق مخصصاً للقراءة فقط.
- عنوان الخادم
https://holasixto.com/mcp- MCP للوثائق
https://holasixto.com/mcp/docsعام ومخصص للقراءة فقط. يبحث في وثائق Sixto ولا يطّلع أبداً على بيانات مؤسستك.
طريقة العمل
- 01
ينشئ مالك مفتاحًا من الإعدادات ويختار الصلاحيات التي يحتاجها. يُعرض المفتاح مرة واحدة.
- 02
أرسله بوصفه رمز Bearer. استدعِ whoami وcapabilities لمعرفة ما يستطيع المفتاح فعله.
- 03
اقرأ أو اكتب عبر نقاط النهاية. تخضع عمليات الكتابة للفحوص نفسها في التطبيق.
- 04
تابع الاستدعاءات في عرض نشاط API، وألغِ المفتاح متى أردت.
البيانات التي تتم مزامنتها
الأسئلة الشائعة
هل توجد إرشادات للمطورين؟
نعم. مرجع OpenAPI 3.1 على /api/v1/openapi.json ودليل العميل على /api/v1/guide.json. تعرض كل عملية x-contract-status: تعني complete عقدًا تمت مراجعته، وتعني unsupported أن المسار يظل متاحًا لكنه خارج واجهة العميل المدعومة. خادم الوثائق للقراءة فقط على /mcp/docs.
باسم من يعمل المفتاح؟
يعمل المفتاح للمؤسسة ضمن صلاحياته. لا يملك قائمة عقارات خاصة به ولا يرث قيود العقارات للشخص الذي أنشأه. عندما يمرر Sixto طلب شخص بتفويض Sixto-On-Behalf-Of، تسري أيضًا قيود ذلك الشخص الحالية على العقارات والصلاحيات.
كيف أغيّر صلاحيات المفتاح؟
أنشئ مفتاحًا بديلًا بالصلاحيات المطلوبة، وانقل أداتك إليه، ثم ألغِ المفتاح القديم. لا يمكن تعديل المفاتيح القائمة. يُرفض المفتاح الملغى في الاستدعاء التالي.
ماذا يعني 422 و429؟
422 يعني فشل التحقق: اقرأ كائن errors لكل حقل، وصحح الإدخال وأعد الإرسال. 429 يعني أن المفتاح بلغ حده: انتظر عدد الثواني في ترويسة Retry-After، ثم أعد المحاولة مع زيادة الفاصل تدريجيًا. احتفظ بـX-Request-Id للعثور على الاستدعاء في سجل النشاط.
هل يستطيع المفتاح فتح باب؟
لا. فتح القفل عن بُعد غير متاح أبدًا عبر واجهة API.
هل لواجهة API إصدار؟
نعم، تقع تحت /api/v1.