تخطَّ إلى المحتوى

التحقق من بيانات اعتمادك

GET /public/v1/is-connected

يجيب سؤالًا واحدًا: هل بيانات الاعتماد هذه سليمة؟ لا يأخذ معاملات، ولا يغير شيئًا، وليس مقيدًا، وهو ما يجعله الاستدعاء الصحيح لفحص الصحة وأول ما تنفذه عند الإعداد. ولترى بمن تتصرف بيانات الاعتماد نيابةً عنه، استدع جلب الحساب الحالي.

وأقرب ما يقابله في أداة CLI من شارك هو الأمر sharek auth:status، الذي يتحقق من بيانات الاعتماد التي تستخدمها الأداة، ولا تقابله أداة في خادم MCP.

Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/is-connected
{ "connected": true }

والقيمة دائمًا true. فبيانات الاعتماد غير الصالحة لا تبلغ هذه الاستجابة أبدًا؛ إذ ترفض بـ 401 قبل تنفيذ العملية، لذا عامل أي 200 على أنه نجاح واقرأ رمز الحالة لا الحقل.

الاستجابة المعنى
401 {"msg": "No API Key found"} لم ترسل ترويسة Authorization.
401 {"msg": "Invalid API key"} المفتاح غير معروف. وبادئة Bearer هي السبب المعتاد.
401 {"msg": "Invalid OAuth token"} رمز pos_ مسحوب أو مجهول.
401 {"msg": "No subscription found"} بيانات الاعتماد صالحة لكن المؤسسة بلا اشتراك فعال.

وتفصيل كل واحدة في المصادقة.