SosoAPI
AR
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
تسجيل الدخول

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

أداة MCP

تحديث الملف الشخصي للمستخدم

sosoapi_update_user_profile

تغيير ملف المستخدم المسجّل نفسه (display_name و timezone و avatar_url و theme). أرسِل الحقول المراد تغييرها فقط.

اقرأ بصيغة Markdown

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
display_namestringاختياري / عنصر
  • minLength: 0
  • maxLength: 120
timezonestringاختياري / عنصر
  • minLength: 1
  • maxLength: 64
avatar_urlstringاختياري / عنصر
  • minLength: 0
  • maxLength: 2048
themestringاختياري / عنصر
  • enum: ["light","dark","system"]
expected_versionintegerاختياري / عنصر

اختياري. الإصدار الذي قرأته. إذا تغيّر بعد ذلك، يفشل التحديث برمز 409 VERSION_CONFLICT بدلاً من الاستبدال.

  • maximum: 2147483647
  • exclusiveMinimum: 0
include_versionbooleanاختياري / عنصر

اختياري. تضيف true إصدار المورد إلى الإجابة.

—
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "display_name": {
      "type": "string",
      "minLength": 0,
      "maxLength": 120
    },
    "timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "avatar_url": {
      "type": "string",
      "minLength": 0,
      "maxLength": 2048
    },
    "theme": {
      "type": "string",
      "enum": [
        "light",
        "dark",
        "system"
      ]
    },
    "expected_version": {
      "description": "Optional. The version you read. If it changed since, the update fails with 409 VERSION_CONFLICT instead of overwriting.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 2147483647
    },
    "include_version": {
      "description": "Optional. true adds the resource version to the answer.",
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
actionstringمطلوب في العنصر الأب
  • const: "update"
profileobjectمطلوب في العنصر الأب
  • additionalProperties: false
profile.user_idstringمطلوب في العنصر الأب
  • format: "uuid"
profile.display_namestring | nullمطلوب في العنصر الأب—
profile.display_nameanyOf 1stringمطلوب في العنصر الأب—
profile.display_nameanyOf 2nullمطلوب في العنصر الأب—
profile.timezonestring | nullمطلوب في العنصر الأب—
profile.timezoneanyOf 1stringمطلوب في العنصر الأب—
profile.timezoneanyOf 2nullمطلوب في العنصر الأب—
profile.avatar_urlstring | nullمطلوب في العنصر الأب—
profile.avatar_urlanyOf 1stringمطلوب في العنصر الأب—
profile.avatar_urlanyOf 2nullمطلوب في العنصر الأب—
profile.avatar_preview_urlstring | nullاختياري / عنصر—
profile.avatar_preview_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
profile.avatar_preview_urlanyOf 2nullاختياري / عنصر—
profile.avatar_preview_expires_atstring | nullاختياري / عنصر—
profile.avatar_preview_expires_atanyOf 1stringاختياري / عنصر
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
profile.avatar_preview_expires_atanyOf 2nullاختياري / عنصر—
profile.themestring | nullمطلوب في العنصر الأب—
profile.themeanyOf 1stringمطلوب في العنصر الأب
  • enum: ["light","dark","system"]
profile.themeanyOf 2nullمطلوب في العنصر الأب—
profile.created_atstring | nullمطلوب في العنصر الأب—
profile.created_atanyOf 1stringمطلوب في العنصر الأب—
profile.created_atanyOf 2nullمطلوب في العنصر الأب—
profile.updated_atstring | nullمطلوب في العنصر الأب—
profile.updated_atanyOf 1stringمطلوب في العنصر الأب—
profile.updated_atanyOf 2nullمطلوب في العنصر الأب—
profile.deletion_scheduled_atstring | nullمطلوب في العنصر الأب—
profile.deletion_scheduled_atanyOf 1stringمطلوب في العنصر الأب—
profile.deletion_scheduled_atanyOf 2nullمطلوب في العنصر الأب—
profile.hard_delete_atstring | nullمطلوب في العنصر الأب—
profile.hard_delete_atanyOf 1stringمطلوب في العنصر الأب—
profile.hard_delete_atanyOf 2nullمطلوب في العنصر الأب—
profile.versionintegerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "const": "update"
    },
    "profile": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "string",
          "format": "uuid"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "timezone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "avatar_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "avatar_preview_url": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "avatar_preview_expires_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "theme": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "light",
                "dark",
                "system"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "deletion_scheduled_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "hard_delete_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "user_id",
        "display_name",
        "timezone",
        "avatar_url",
        "theme",
        "created_at",
        "updated_at",
        "deletion_scheduled_at",
        "hard_delete_at"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "action",
    "profile"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

{
  "name": "sosoapi_update_user_profile",
  "arguments": {}
}

structuredContent

{
  "action": "update",
  "profile": {
    "user_id": "11111111-1111-4111-8111-111111111111",
    "display_name": null,
    "timezone": null,
    "avatar_url": null,
    "theme": null,
    "created_at": null,
    "updated_at": null,
    "deletion_scheduled_at": null,
    "hard_delete_at": null
  }
}
تثبيت MCP أو ربطه