GET/api/public/v1/me

profile.read

所需权限: profile:read
类别: 只读
计费: 不计费
幂等: 不需要
MCP 工具: 无

参数

X-Workspace-Id位置 header必填否类型 string (uuid)

请求体

没有请求体

成功响应 200

{
  "type": "object",
  "properties": {
    "actor": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "displayName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "role": {
          "type": "string",
          "const": "teacher"
        }
      },
      "required": [
        "id",
        "displayName",
        "role"
      ],
      "additionalProperties": false
    },
    "workspace": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        }
      },
      "required": [
        "id",
        "name"
      ],
      "additionalProperties": false
    },
    "authorization": {
      "type": "object",
      "properties": {
        "grantId": {
          "type": "string",
          "format": "uuid"
        },
        "clientId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "scopes": {
          "minItems": 1,
          "maxItems": 21,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "profile:read",
              "problems:read",
              "classes:read",
              "classes:write",
              "roster:read",
              "roster:write",
              "students:manage",
              "students:pii",
              "grades:read",
              "grades:submit",
              "grades:review",
              "grades:publish",
              "ingestions:read",
              "ingestions:write",
              "ingestions:review",
              "ingestions:publish",
              "papers:read",
              "papers:write",
              "files:write",
              "exports:read",
              "originals:read"
            ]
          }
        }
      },
      "required": [
        "grantId",
        "clientId",
        "scopes"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "actor",
    "workspace",
    "authorization"
  ],
  "additionalProperties": false
}

可能返回的错误状态码

400401403404409429500503

所有错误都用同一种错误信封返回，原因码见错误与限流。