Sökningen laddas först när du använder den. Bläddra bland alla kategorier nedan.

MCP-verktyg

Hämta användarprofil

sosoapi_get_user_profile

Läs den inloggade användarens egen profil (visningsnamn, tidszon, avatar, tema); profile är null tills en profil finns.

Läs som Markdown

Profiler och transporter

Profiler: full · Transporter: stdio, http

Välj core eller full för att styra vilka verktyg klienten ser; detta ändrar inte dess behörigheter. Lokal filuppladdning kräver stdio och är inte tillgänglig via HTTP. Ange SOSOAPI_OUTPUT_SCHEMAS=1 för att inkludera utdatascheman vid identifiering. Verktygen returnerar strukturerade resultat med eller utan inställningen.

Behörigheter och sidoeffekter

Annoteringar hjälper klienter att beskriva ett verktyg. Varje anrop kontrollerar fortfarande användarens autentisering, roll, resursåtkomst och tilldelade funktionsbehörigheter.

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

Indatafält

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Indatafält
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
include_versionbooleanValfritt / objekt

Valfritt. true lägger till resursversionen i svaret.

—
Fullständigt JSON Schema
{
  "type": "object",
  "properties": {
    "include_version": {
      "description": "Optional. true adds the resource version to the answer.",
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

Strukturerat resultat

Detta schema beskriver structuredContent i ett lyckat verktygsresultat. MCP-svaret innehåller även content och kan ange isError när ett anrop misslyckas. För publicering ska du läsa inläggets slutresultat i stället för att tolka en accepterad begäran eller ett textsvar som bekräftelse. Den länkade API-åtgärden förklarar behörigheter och regler för nya försök.

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Strukturerat resultat
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
actionstringObligatoriskt i överordnat objekt
  • const: "get"
profileobject | nullObligatoriskt i överordnat objekt—
profileanyOf 1objectObligatoriskt i överordnat objekt
  • additionalProperties: false
profile.user_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
profile.display_nameanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.display_nameanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt—
profile.display_nameanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.timezoneanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.timezoneanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt—
profile.timezoneanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.avatar_urlanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.avatar_urlanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt—
profile.avatar_urlanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.avatar_preview_urlanyOf 1string | nullValfritt / objekt—
profile.avatar_preview_urlanyOf 1 / anyOf 1stringValfritt / objekt
  • format: "uri"
profile.avatar_preview_urlanyOf 1 / anyOf 2nullValfritt / objekt—
profile.avatar_preview_expires_atanyOf 1string | nullValfritt / objekt—
profile.avatar_preview_expires_atanyOf 1 / anyOf 1stringValfritt / objekt
  • 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 1 / anyOf 2nullValfritt / objekt—
profile.themeanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.themeanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • enum: ["light","dark","system"]
profile.themeanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.created_atanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.created_atanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt—
profile.created_atanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.updated_atanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.updated_atanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt—
profile.updated_atanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.deletion_scheduled_atanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.deletion_scheduled_atanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt—
profile.deletion_scheduled_atanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.hard_delete_atanyOf 1string | nullObligatoriskt i överordnat objekt—
profile.hard_delete_atanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt—
profile.hard_delete_atanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
profile.versionanyOf 1integerValfritt / objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
profileanyOf 2nullObligatoriskt i överordnat objekt—
Fullständigt JSON Schema
{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "const": "get"
    },
    "profile": {
      "anyOf": [
        {
          "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
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "action",
    "profile"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Exempel på verktygsanrop

Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop.

{
  "name": "sosoapi_get_user_profile",
  "arguments": {}
}

structuredContent

{
  "action": "get",
  "profile": null
}
Installera eller anslut MCP