انتقل إلى المحتوى
مهنارو

مهنارو للمطوّرين

بيانات الموارد البشرية في أنظمتك أنت

واجهة REST API لتطبيقات الجوال والتكاملات، وخوادم MCP لمساعدات الذكاء الاصطناعي. كلاهما يستخدم حسابات النظام وصلاحياته وقواعده نفسها، بالعربية والإنجليزية.

REST API

https://api.mihnaro.com/api/v1

MCP · app

https://api.mihnaro.com/mcp/app

MCP · platform

https://api.mihnaro.com/mcp/platform
1249 نقطة وصول و 461 أداة MCP

الأدلة

الدخول

تطبيقات الجوال: رموز التطبيق

يدخل مستخدم الشركة ببريده وكلمة مروره، فيحصل على رمز لواجهة التطبيق وخادم MCP الخاص به. التحقق بخطوتين وقواعد كلمة المرور تُطبَّق كما في النظام.

POST /api/v1/app/token

التكاملات: مفاتيح API للشركة

ينشئ مديرو الشركة المفاتيح من الإعدادات ← التكاملات. يبدأ المفتاح بـ mhk_، ويعمل على شركته فقط، ويتصرّف باسم الشخص الذي أُنشئ له، ويمكن حصره في القراءة أو الإضافة أو التعديل أو الحذف، وفي عناوين IP محددة وتاريخ انتهاء.

Authorization: Bearer mhk_…

فريق مهنارو: مفاتيح المنصة

واجهة المنصة وخادم MCP الخاص بها يديران الشركات والتراخيص والموقع. هذه المفاتيح لمشرفي منصة مهنارو فقط.

/api/v1/platform · /mcp/platform

قواعد كل طلب

  • الصلاحيات. كل طلب يتحقق من ترخيص الشركة، ثم دور الشخص، ثم النطاق الممنوح له، تماماً كما يفعل النظام.
  • حدود الطلبات. 60 طلباً في الدقيقة لواجهة التطبيق، و120 لواجهة المنصة، و10 لطلبات الدخول وكلمة المرور. بعد الحد يكون الرد 429 مع Retry-After.
  • اللغات. أرسل Accept-Language: ar لتصلك الرسائل بالعربية؛ الإنجليزية هي الافتراضية.
  • الأخطاء. دائماً بصيغة JSON، فيها رسالة ورمز عند الحاجة مثل password_change_required.
  • الـ Webhooks. يمكن للشركات أيضاً أن تستقبل أحداثها على عناوينها، موقّعة بـ HMAC-SHA256.

أول طلب

curl -X POST https://api.mihnaro.com/api/v1/app/token \
  -H "Accept: application/json" \
  -d [email protected] -d password=… \
  -d device_name="My app"

curl https://api.mihnaro.com/api/v1/app/me \
  -H "Authorization: Bearer <token>" \
  -H "Accept-Language: ar"

المرجع يعرض كل نقطة وصول والصلاحية التي تحتاجها، وكل أدوات MCP. reference.json · openapi.json

تريد أن ترى البيانات أولاً؟

جرّب العرض التجريبي، أو اقرأ مركز المساعدة.

نستخدم ملفات تعريف الارتباط لنفهم كيف يُستخدم الموقع. يمكنك القبول أو الرفض.