تخطَّ إلى المحتوى الرئيسي
تصفّح التوثيق

المفاتيح والرموز والمعرّفات

مرجع موحَّد لصيغ بيانات الاعتماد والمعرّفات المستخدمة في Syncanix: مفاتيح واجهة برمجة التطبيقات السرية والقابلة للنشر، ورموز اتصال MCP، والبيئات.

يستخدم Syncanix بضع صيغ متمايزة لبيانات الاعتماد والمعرّفات. يعرض هذا الجدول كلاً منها وأين يُستخدم؛ والشرح الكامل موجود في الصفحات المرتبطة.

مفاتيح واجهة برمجة التطبيقات

المفتاح السري
من جهة الخادم فقط — تستخدمها الأداة (رفع الكتالوج) وبيئة تشغيل Node SDK. تبدأ بالبادئة gak_ ولا تُضمَّن أبدًا في صفحة. ولا يستخدم عملاء MCP هذا المفتاح؛ بل يتفويضون برمز اتصال OAuth منفصل.
المفتاح القابل للنشر
آمن للدمج في موقعك — تستخدمه الأداة. ببادئة pk_، مع متغيّرَي اختبار ومباشر منفصلين.
gak_<env>_<32 base32 chars>    # secret key — CLI / MCP / server-side only
pk_<test|live>_<32 base32 chars>  # publishable key — embedded in your page

رموز اتصال MCP

يُصرَّح باتصال MCP برمز يقيّد عميل ذكاء اصطناعي بمساحة عملك. عامِله كمفتاح سري.

البيئات

تُفصَل المفاتيح والإعداد حسب البيئة، بحيث لا يمسّ الاختبار حركة المرور المباشرة أبداً:

التطوير
للبناء والاختبار، بمفاتيح اختبار.
الإنتاج
للمستخدمين الحقيقيين، بمفاتيح مباشرة.

الخطوات التالية