جلب الحساب الحالي
GET /public/v1/meيخبرك بمن تتصرف بيانات الاعتماد نيابةً عنه: المؤسسة، ومع رمز OAuth، الشخص الذي وافق على تطبيقك. فبينما يكتفي التحقق من بيانات اعتمادك بتأكيد أن بيانات الاعتماد تعمل، يسمي هذا الاستدعاء الحساب الذي وراءها. لا يأخذ معاملات، ولا يغير شيئًا، وليس مقيدًا.
وهذه العملية لا يقابلها أمر في أداة CLI من شارك، ولا أداة في خادم MCP من شارك.
بمفتاح API:
curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/meبرمز OAuth:
curl -H "Authorization: pos_your_oauth_token" \ https://dash.sharek.app/api/public/v1/meالاستجابة
Section titled “الاستجابة”بمفتاح API، تكون قيمة user هي null:
{ "organization": { "id": "organization-id", "name": "Acme Agency" }, "user": null}برمز OAuth، يكون user هو الشخص الذي وافق على تطبيقك:
{ "organization": { "id": "organization-id", "name": "Acme Agency" }, "user": { "id": "user-id", "name": "Jane Doe", "picture": "https://media.example.com/a1b2c3d4e5.png" }}| الحقل | الوصف |
|---|---|
organization.id |
المؤسسة التي تتصرف بيانات الاعتماد نيابةً عنها. ومع رمز OAuth، هي القيمة نفسها التي يحملها id في استجابة تبادل الرموز. |
organization.name |
اسم تلك المؤسسة. |
user |
null مع مفتاح API، لأن المفتاح ملك المؤسسة كلها لا ملك شخص واحد. ومع رمز OAuth، الشخص الذي وافق على تطبيقك في شاشة التصريح. |
user.id |
معرف ذلك الشخص. |
user.name |
اسمه، أو null إن لم يضبط له اسم. |
user.picture |
عنوان صورة ملفه الشخصي، أو null إن لم تكن له صورة. |
ملاحظات
Section titled “ملاحظات”- الاستدعاء الطبيعي بعد تبادل OAuth. فاستجابة تبادل الرموز تخبرك أي مؤسسة وصلت إليها، وهذا الاستدعاء يضيف من ربطها، ليعرض منتجك شيئًا مثل «متصل باسم Jane Doe، Acme Agency».
- لتعرف أي شخص يستدعي، استخدم رمز OAuth. فمفتاح API يمثل المؤسسة كلها، ولذلك لا يذكر شخصًا أبدًا (انظر المصادقة).
- هذا الاستدعاء غير مقيد؛ فالتقييد على إنشاء المنشورات وحده (انظر حد الطلبات).
الإخفاقات
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"} |
بيانات الاعتماد صالحة لكن المؤسسة بلا اشتراك فعال. |
وتفصيل كل واحدة في المصادقة.