# أوكتراهاير للمطوّرين: الواجهة البرمجية (API) والويب هوك وMCP

> ابنِ على أوكتراهاير: واجهة REST عامة بمفاتيح محدّدة الصلاحيات، وويب هوك موقّع لأحداث التوظيف، وخادم MCP للمساعدات الذكية، مع حالة كل منها.

Source: https://octrahire.ai/ar/developers

اربط أنظمتك ومساعداتك بأوكتراهاير. الواجهة البرمجية العامة والويب هوك وخادم MCP متاحة تجريبيًا اليوم.

## ما يتصل بأوكتراهاير، وحالته

- **MCP بتسجيل الدخول OAuth وإجراءات تؤكّدها** (تجريبي): لـ Claude وChatGPT وCopilot وGemini وClaude Code وCodex وCursor.
- **MCP برموز شخصية، للقراءة فقط** (تجريبي): البحث والسؤال وقراءة النصوص من Claude Code وCodex وCursor وغيرها.
- **واجهة REST العامة v1** (تجريبي): الوظائف والطلبات والمقابلات وبطاقات التقييم والعروض والموافقات.
- **مفاتيح الواجهة البرمجية بصلاحيات** (تجريبي): عدة مفاتيح مسمّاة لكل مساحة عمل، لكل منها صلاحياتها وتاريخ انتهائها.
- **رموز وصول OAuth** (تجريبي): لتطبيقات الشركاء، تعمل باسم الشخص الذي سجّل الدخول.
- **Standard Webhooks** (تجريبي): أحداث توظيف موقّعة، بأسرار يمكن تدويرها، مع سجل للتسليم وإعادة إرسال.
- **مواصفة OpenAPI 3.1** (تجريبي): مولَّدة من الواجهة، للعملاء ومولّدات الشيفرة.

متاح: يعمل اليوم في بيئة التشغيل. تجريبي: منشور ويمكن استخدامه اليوم، وقد يتغيّر. قريبًا: غير متاح للاستخدام بعد.

## قواعد تلتزم بها كل بيانات اعتماد

- تعمل باسم شخص أو مساحة عمل، بصلاحيات لا تتجاوزها أبدًا
- تنطبق المراجعة دون كشف الهوية: يعود المرشح المخفي دون اسم أو بريد أو هاتف أو صورة
- لا حذف، باستثناء إزالة الويب هوك الخاص بك وإلغاء بيانات الاعتماد
- تقبل عمليات الكتابة مفتاح Idempotency-Key، فلا تُنفَّذ إعادة المحاولة مرتين
- يُسجَّل كل طلب من خارج لوحة التحكم مع بيانات الاعتماد التي استخدمها

## المراجع التقنية

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

عنوان خادم MCP:

```
https://api.octrahire.ai/api/v1/assistant/mcp
```

مواصفة OpenAPI 3.1:

```
https://api.octrahire.ai/api/v1/public/openapi.json
```

[مراجع المطوّرين (بالإنجليزية)](https://octrahire.ai/developers)

## هل لدى أوكتراهاير واجهة برمجية (API)؟

نعم، تجريبيًا. واجهة REST عامة تحت ‎/api/v1/public، بمفاتيح الواجهة البرمجية محدّدة الصلاحيات أو رموز وصول OAuth، وويب هوك موقّع وفق Standard Webhooks لأحداث التوظيف، ومواصفة OpenAPI 3.1. وخادم MCP للمساعدات الذكية، بتسجيل الدخول بحساب أوكتراهاير وإجراءات تؤكّدها، لـ Claude وChatGPT وMicrosoft Copilot وGemini وClaude Code وCodex وCursor. ومراجعها التفصيلية بالإنجليزية.