SJTU jAccount Profile

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/shanghai-jiao-tong-university/main/json-schema/shanghai-jiao-tong-university-profile.json",
  "title": "SJTU jAccount Profile",
  "description": "Generated by API Evangelist, derived from Shanghai Jiao Tong University's own published documentation — SJTU publishes no JSON Schema. The user object returned in entities[0] by GET https://api.sjtu.edu.cn/v1/me/profile and GET /v1/profile/{account}. Derived from the 响应参数 structure at https://developer.sjtu.edu.cn/api/profile.html. Field release is SCOPE-CONTROLLED: each property below names the scopes that release it, and a token holding only `basic` receives a strict subset of a token holding `privacy`. This is field-level authorization implemented in the platform, and it is a genuinely uncommon design worth naming — the same operation returns a different object shape depending on what was approved.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Natural-person identifier (GUID). Released to basic, essential, profile, privacy. Absent on non-personal accounts such as group accounts. Multiple accounts belonging to the same natural person share this id.",
      "x-scopes": [
        "basic",
        "essential",
        "profile",
        "privacy"
      ]
    },
    "account": {
      "type": "string",
      "description": "jAccount account name.",
      "x-scopes": [
        "basic",
        "essential",
        "profile",
        "privacy"
      ]
    },
    "name": {
      "type": "string",
      "description": "Real name.",
      "x-scopes": [
        "basic",
        "essential",
        "profile",
        "privacy"
      ]
    },
    "kind": {
      "type": "string",
      "const": "canvas.profile",
      "description": "Object type marker. Every SJTU object carries a kind that uniquely identifies its type.",
      "x-scopes": [
        "basic",
        "essential",
        "profile",
        "privacy"
      ]
    },
    "code": {
      "type": "string",
      "description": "Student or staff number of the default identity.",
      "x-scopes": [
        "essential",
        "profile",
        "privacy"
      ]
    },
    "userType": {
      "type": "string",
      "description": "Identity type of the default identity. Enumerated in vocabulary/shanghai-jiao-tong-university-vocabulary.yml.",
      "enum": [
        "faculty",
        "student",
        "yxy",
        "fs",
        "vip",
        "postphd",
        "external_teacher",
        "summer",
        "alumni",
        "green",
        "outside",
        "fszxjs",
        "freshman",
        "team"
      ],
      "x-scopes": [
        "essential",
        "profile",
        "privacy"
      ]
    },
    "organize": {
      "type": "object",
      "description": "Organizational unit of the default identity.",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "x-scopes": [
        "essential",
        "profile",
        "privacy"
      ]
    },
    "topOrganize": {
      "type": "object",
      "description": "Second-level unit owning the default identity. The documentation explicitly warns against persisting this value, because it is re-derived as the directory changes.",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "x-scopes": [
        "essential",
        "profile",
        "privacy"
      ]
    },
    "classNo": {
      "type": "string",
      "description": "Class number. Present only when userType is student.",
      "x-scopes": [
        "profile",
        "privacy"
      ]
    },
    "avatars": {
      "type": "object",
      "description": "Avatar images.",
      "properties": {
        "uriTiny": {
          "type": "string",
          "format": "uri"
        },
        "uriNormal": {
          "type": "string",
          "format": "uri"
        }
      },
      "x-scopes": [
        "privacy"
      ]
    },
    "timeZone": {
      "type": "integer",
      "description": "Time-zone offset."
    },
    "uri": {
      "type": "string",
      "format": "uri",
      "description": "Web address for the object, per the platform-wide convention that every object carries a uri."
    }
  }
}