التحقق من بيانات اعتمادك
GET /public/v1/is-connectedيجيب سؤالًا واحدًا: هل بيانات الاعتماد هذه سليمة؟ لا يأخذ معاملات، ولا يغير شيئًا، وليس مقيدًا، وهو ما يجعله الاستدعاء الصحيح لفحص الصحة وأول ما تنفذه عند الإعداد. ولترى بمن تتصرف بيانات الاعتماد نيابةً عنه، استدع جلب الحساب الحالي.
وأقرب ما يقابله في أداة CLI من شارك هو الأمر sharek auth:status،
الذي يتحقق من بيانات الاعتماد التي تستخدمها الأداة، ولا تقابله أداة في خادم MCP.
curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/is-connectedالاستجابة
Section titled “الاستجابة”{ "connected": true }والقيمة دائمًا true. فبيانات الاعتماد غير الصالحة لا تبلغ هذه الاستجابة أبدًا؛ إذ ترفض بـ
401 قبل تنفيذ العملية، لذا عامل أي 200 على أنه نجاح واقرأ رمز الحالة لا الحقل.
الإخفاقات
Section titled “الإخفاقات”| الاستجابة | المعنى |
|---|---|
401 {"msg": "No API Key found"} |
لم ترسل ترويسة Authorization. |
401 {"msg": "Invalid API key"} |
المفتاح غير معروف. وبادئة Bearer هي السبب المعتاد. |
401 {"msg": "Invalid OAuth token"} |
رمز pos_ مسحوب أو مجهول. |
401 {"msg": "No subscription found"} |
بيانات الاعتماد صالحة لكن المؤسسة بلا اشتراك فعال. |
وتفصيل كل واحدة في المصادقة.