Octri لإنشاء توثيق API ومكتبات العملاء من المواصفات

Octri منصة لإنشاء توثيق API اعتمادًا على ملف مواصفات الواجهة. تجمع بين صفحات مرجعية قابلة للتحرير ومكتبات SDK وأدوات MCP ومراقبة التكاملات، بحيث يعتمد أكثر من جزء من تجربة المطور على المصدر نفسه.

ما فائدة Octri ببساطة؟

تخيّل أن مواصفات API هي كتيّب يشرح الطلبات التي تقبلها خدمتك والبيانات التي تعيدها. يحوّل Octri هذا الكتيّب إلى موقع يقرأه المطور، ومكتبة برمجية يثبّتها داخل تطبيقه، وأدوات يستطيع مساعد ذكاء اصطناعي استخدامها للوصول إلى الواجهة.

يناسب ذلك شركات البرمجيات كخدمة ومزوّدي واجهات API والفرق الصغيرة التي تدير عدة تكاملات. تحتاج أولًا إلى واجهة عاملة ومواصفات صالحة؛ فالمنصة لا تبني الخدمة الفعلية بدلًا منك، ويجب مراجعة النصوص والشيفرة الناتجة. ويمكن استخدام الوحدات بصورة مستقلة دون تفعيلها جميعًا.

كيف تنشر توثيقًا انطلاقًا من مواصفاتك؟

يستورد API Studio ملف المواصفات أو يتصل بمستودع GitHub. يعرض مخططات البيانات وأمثلة الطلبات، ويُنشئ مسودات شرح للعمليات. يمكنك تعديل الصفحات وإضافة أدلة MDX لشرح المصادقة أو خطوات الربط.

1. استورد الملف وراجع أسماء العمليات وطرق المصادقة ومخططات الطلب والاستجابة.
2. أنشئ التوثيق ثم قارن الشرح بسلوك الواجهة الفعلي.
3. جرّب عملية في بيئة اختبار باستخدام وحدة الطلبات التفاعلية، بما في ذلك حالة خطأ. تُرسل الطلبات من المتصفح، لذلك تؤثر إعدادات CORS الخاصة بواجهتك.
4. اضبط خيارات النشر ولغات SDK والاتصالات بسجلات الحزم عند الحاجة.
5. راجع المسودة والفروق ثم وافق على النشر.

تتوفر مزامنة GitHub في جميع الخطط. يمكن لتغيير المواصفات بدء إعادة البناء، لكن المسار الرسمي يحتفظ بخطوة موافقة قبل نشر إصدارات SDK الجديدة إلى سجلات الحزم.

مكتبات عملاء بعشر لغات

يدعم SDK Studio لغات TypeScript وPython وGo وJava وKotlin وRuby وPHP وRust وSwift وDart. يمكنك ضبط أسماء الدوال واستبعاد عمليات معينة وتخصيص إعدادات اللغة، ثم استخدام تكاملات سجلات الحزم لتوزيع المكتبة.

هذا عدد اللغات التي تدعمها المنصة إجمالًا؛ أما عدد اللغات التي يمكنك تفعيلها فيحدده الاشتراك. تتوفر إضافة شيفرة مخصصة إلى SDK بدءًا من Growth. راجع المصادقة والاستجابات غير المعتادة قبل توزيع المكتبة على المستخدمين.

إتاحة المرجع والعمليات للمساعدين عبر MCP

يوفر خادم MCP سبع أدوات للتوثيق، ويمكنه تحويل عمليات API المضمّنة إلى أدوات قابلة للتنفيذ. يستطيع Claude أو Cursor أو عميل متوافق مع MCP قراءة المرجع المنشور بدل الاعتماد على معرفة النموذج وحدها.

يكفي معرّف المشروع للوصول إلى التوثيق. أما تنفيذ الطلبات فيحتاج إلى بيانات اعتماد مناسبة تبقى على الجهاز الذي يشغّل الخادم. حدّد البيئة والصلاحيات واستبعد العمليات الحساسة قبل تمكين التنفيذ، خصوصًا عند التعامل مع بيانات حقيقية.

الخطة المجانية والأسعار وحدود الاستخدام

تم التحقق في 6 أكتوبر 2026. الأسعار الشهرية الرسمية بالدولار الأمريكي، قبل الضرائب، وليست تسعيرًا محليًا لبلد بعينه:

• Free: مشروع واحد ولغة SDK واحدة و50 عملية API و100 ميغابايت من بيانات المراقبة شهريًا، مع 100 رصيد ذكاء اصطناعي تُمنح مرة واحدة.
• Starter: ‏49 دولارًا شهريًا، مع لغتين لمكتبات SDK.
• Growth: ‏99 دولارًا شهريًا، مع أربع لغات وإدارة الإصدارات وشيفرة ومكونات مخصصة.
• Business: ‏249 دولارًا شهريًا، مع اللغات العشر وخيارات العلامة البيضاء.
• Enterprise: تسعير حسب العرض؛ يمكن تشغيل المولّد وعارض التوثيق داخل بنيتك التحتية.

يستهلك توليد شرح عملية واحدة أو تقديم إجابة واحدة عبر Ask-the-docs رصيدًا واحدًا. لا يستهلك التحرير اليدوي أو بناء SDK أو الاستضافة هذا الرصيد. عند نفاده تتوقف وظائف التوليد والإجابة بالذكاء الاصطناعي، بينما يستمر التوثيق المنشور والبناء والمراقبة. راجع مقارنة خطط Octri للحصص والإضافات الحالية.

يتضمن Free أيضًا النطاق المخصص ومزامنة GitHub.

متابعة الأعطال وفهم مسار البيانات

المراقبة معطلة افتراضيًا. عند تفعيلها لمكتبات SDK الناتجة أو الحزم الخلفية المدعومة، توفر سجلات ومشكلات مجمعة وتتبعًا وفحوص توفر وتنبيهات. يوضح Octri وجود تنقيح للبيانات الحساسة على جهاز العميل ثم عند استقبالها.

تذكر سياسة الخصوصية أن النص اللازم من المواصفات يرسل إلى مزوّد النموذج للتوليد، وأن السؤال والمقاطع ذات الصلة ترسل للإجابة عبر Ask-the-docs. كما تُعالج نصوص التوثيق لإنشاء تمثيلات بحث متجهية. تقول الشركة إنها ومزوّديها لا يستخدمون هذه البيانات لتدريب النماذج. تظل هذه معالجة ضمن خدمة مستضافة وليست عملية محلية بالكامل.

أسئلة شائعة

هل توجد خطة مجانية؟

نعم، ضمن الحدود المذكورة أعلاه. أرصدة Free المئة لا تتجدد شهريًا، لذا احسب عدد العمليات التي تريد توليد شرح لها قبل استهلاكها.

ما صيغ المواصفات المدعومة؟

تسرد الشركة OpenAPI 3.0 و3.1 وSwagger 2.0 وPostman وAsyncAPI بصيغتي JSON وYAML. راجع نتيجة الاستيراد ومخططات البيانات قبل اعتماد المرجع.

هل تضيع التعديلات اليدوية عند التحديث؟

وفق Octri، تُحفظ الحقول التي عدّلتها يدويًا، ويمكن تحديث الحقول المولدة التي لم تُعدّل. تبقى مراجعة المسودة والفروق ضرورية عند تغيير المواصفات.

مصادر رسمية للمطورين

• توثيق Octri: الإعداد وأدلة SDK وربط MCP.
• مستودعات Octri على GitHub: الحزم العامة والإبلاغ عن مشكلات SDK.
• دعم المنتج والفوترة: قنوات المساعدة الرسمية.