الحسابمن أنا
العودة إلى Sofia

الحساب

من أنا

يصف الرمز المستدعي: نوعه وتطبيقه والشخص الذي يتصرف نيابةً عنه ومساحات عمله وصلاحياته ووضعه وانتهاءه. يقرؤه أي رمز صالح.

GEThttps://api.sofia-post.com/api/v1/me
GET/v1/me
curl -X GET 'https://api.sofia-post.com/api/v1/me' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

التفويضات

  • Authorizationstringمطلوب

    مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

الاستجابة

200application/json

هوية الرمز المستدعي ونطاق صلاحياته.

  • tokenTypestringمطلوب

    نوع الرمز: personal_key أو authorization_code أو client_credentials

    القيم المسموحة: personal_keyauthorization_codeclient_credentials

  • applicationobjectمطلوب

    التطبيق وراء الرمز

    عرض الخصائص الفرعية
    • idstringمطلوب

      معرّف التطبيق (أو المفتاح الشخصي)

    • clientIdstringمطلوب

      قيمة client_id للتطبيق

    • namestringمطلوب

      اسم التطبيق

  • userobjectمطلوب

    الشخص الذي يتصرف الرمز نيابةً عنه

    عرض الخصائص الفرعية
    • idstringمطلوب

      الشخص الذي يتصرف الرمز نيابةً عنه: كاتب المفتاح، أو من منح الموافقة

  • coveragestringمطلوب

    workspace: مساحة عمل واحدة؛ account: كل المساحات التي ينتمي إليها كاتب المفتاح

    القيم المسموحة: workspaceaccount

  • workspacesobject[]مطلوب

    حيث يتصرف الرمز الآن

    عرض الخصائص الفرعية
    • idstringمطلوب

      معرّف مساحة العمل

    • namestringمطلوب

      تُسمّى باسم منشآتها النشطة

  • scopesstring[]مطلوب

    الصلاحيات التي يحملها الرمز

  • modestringمطلوب

    test أو live

    القيم المسموحة: testlive

  • expiresAtstring<date-time>

    وقت انتهاء الرمز؛ يغيب لمفتاح بلا انتهاء

4XXapplication/json

أي خطأ آخر، ضمن غلاف الخطأ.