Tongji University Open Platform

The university's own institutional data and capability API platform, operated by the Tongji University Information Office. Roughly 234 documented interfaces across fifteen families: personnel, student, teacher, teaching management, research, school management, library, campus-card and access control, asset and procurement, education-data verification, AI services, notifications, calendar, cloud meeting and electronic signature. Routes carry a version segment (/v1/, /v2/) and a delivery-mode segment — `rt` for real-time queries against the system of record, `dc` for warehouse-served batch data, `infra` for shared campus capabilities, `metadata` for reference code tables. Interfaces are called with an OAuth 2.0 bearer token from the platform's Keycloak realm under either client-credentials or authorization-code mode; thirteen reference-metadata interfaces need no credential at all and were confirmed callable on 2026-09-01. Rate limiting is a documented token bucket at 50 requests per second per application per IP, with 429 on exhaustion. Notably, every interface page names the upstream system of record it draws from — a provenance practice most university platforms do not have.

Operations 13

GET /v1/metadata/asset/campus_gate Campus and campus-gate reference list #
GET /v1/metadata/meeting/meeting_room Meeting room reference list #
GET /v1/metadata/teacher/send_user_types Dispatched-staff category code list #
GET /v1/metadata/teacher/status Faculty and staff employment status code list #
GET /v1/metadata/teacher/tech_job_code Professional-technical post category code list #
GET /v1/metadata/teacher/tech_job_level_code Professional-technical post level code list #
GET /v1/metadata/teacher/tech_level_of_workers_code Worker technical grade code list #
GET /v1/metadata/teacher/title_code Appointed professional-technical title code list #
GET /v1/metadata/teacher/types Faculty and staff personnel category code list #
GET /v1/metadata/user/person_idcard_type Identity-document type code list #
GET /v1/metadata/user/sex_code Gender code list #
GET /v2/metadata/student/accom_building_code Dormitory building code list #
GET /v2/metadata/student/accom_region_code Dormitory region code list #

Documentation

Specifications

Schemas & Data

Other Resources

🔗
Scopes
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/scopes/tongji-open-platform-scopes.yml
🔗
Errors
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/errors/tongji-open-platform-errors.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/examples/tongji-v1-metadata-user-sex-code-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/examples/tongji-v1-metadata-asset-campus-gate-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/examples/tongji-v2-metadata-student-accom-building-code-example.json
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/vocabulary/tongji-open-platform-reference-metadata.yml
🔗
Rules
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/rules/tongji-open-platform-rules.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/lifecycle/tongji-open-platform-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/conformance/tongji-education-standards-conformance.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/json-ld/tongji-context.jsonld
🔗
Support
https://api.tongji.edu.cn/docs/intro/apply/contact_us
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/open-platform"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tongji-reference-metadata-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Tongji University Open Platform — Reference Metadata
  version: '2026-09-01'
  summary: Openly callable code tables (metadata dictionaries) that define the controlled vocabularies
    used across every other Open Platform interface.
  description: 'The Tongji University Open Platform (同济大学开放平台) is operated by the university itself at
    api.tongji.edu.cn, on China Education and Research Network (CERNET) address space, and exposes campus
    data and shared capability interfaces to faculty, students and campus applications.


    This document was DERIVED by API Evangelist from the platform''s own published Chinese-language interface
    documentation at https://api.tongji.edu.cn/docs — one operation per documented interface, with parameters,
    response fields, HTTP method and authorization mode taken from the published tables. It is not published
    by Tongji University and is not authoritative; the documentation site is.


    It covers a representative subset of the platform: AI services, assets and procurement, education-data
    verification, library, reference metadata and research. The full platform documents roughly 234 interfaces
    across fifteen groups, including personnel, student, teaching, campus-card and notification families
    that are not modelled here.


    Thirteen of the operations below are documented as 无需授权可直接访问 (directly accessible, no authorization)
    and were confirmed anonymously callable on 2026-09-01, returning HTTP 200 application/json. Every
    other operation requires an OAuth 2.0 access token issued by the platform''s Keycloak realm and a
    scope granted through the platform''s application-and-approval process.


    This document is the Reference Metadata slice of the derived Tongji Open Platform contract; the unsplit
    source is openapi/_original/tongji-open-platform-openapi.yml.'
  contact:
    name: Tongji University Information Office — Open Platform
    url: https://api.tongji.edu.cn/docs/intro/apply/contact_us
  x-provenance:
    generated: '2026-09-01'
    method: derived
    source: https://api.tongji.edu.cn/docs — 43 published interface documentation pages fetched 2026-09-01
      (HTTP 200), plus live probes of the 13 anonymous interfaces.
    x-operator: institution
servers:
- url: https://api.tongji.edu.cn
  description: Tongji University Open Platform production host (CERNET, 202.120.182.237).
externalDocs:
  description: Tongji University Open Platform documentation
  url: https://api.tongji.edu.cn/docs
tags:
- name: Reference Metadata
  description: Openly callable code tables (metadata dictionaries) that define the controlled vocabularies
    used across every other Open Platform interface.
security:
- openPlatformOAuth: []
paths:
  /v1/metadata/asset/campus_gate:
    get:
      operationId: v1_metadata_asset_campus_gate
      summary: Campus and campus-gate reference list
      description: '校区和校门信息 Original documented title: 校区校门. Authorization modes declared by the platform:
        无需授权可直接访问. Documentation last updated: 2026年06月09日 09时08分07秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/v1_metadata_asset_campus_gate
      security: []
      x-anonymous-access: true
      parameters:
      - name: isUseCode
        in: query
        required: false
        description: 默认不传查看当前生效数据  传0可以查看全量数据,包含生效和失效的所有记录
        schema:
          type: string
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataAssetCampusGateItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - allowCarCode: '1'
                      campus: A02
                      campusDesc: 四平路校区
                      isUseCode: '1'
                      lctnDesc: 校区
                      lctnId: '196'
                      lctnName: 四平路校区
                      parentId: '127'
                    - allowCarCode: '1'
                      campus: A08
                      campusDesc: 嘉定校区
                      isUseCode: '1'
                      lctnDesc: 校区
                      lctnId: '168'
                      lctnName: 嘉定校区
                      parentId: '127'
                    - allowCarCode: '1'
                      campus: A06
                      campusDesc: 南校区
                      isUseCode: '1'
                      lctnDesc: 校园大门
                      lctnId: '131'
                      lctnName: 赤峰路67号
                      parentId: '203'
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/meeting/meeting_room:
    get:
      operationId: v1_metadata_meeting_meeting_room
      summary: Meeting room reference list
      description: '会议室信息 Original documented title: 会议室信息. Upstream system of record declared by the
        platform: SYS20230189(会议管理系统). Authorization modes declared by the platform: 无需授权可直接访问. Documentation
        last updated: 2026年06月09日 09时00分45秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/meeting_room/v1_metadata_meeting_meeting_room
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataMeetingMeetingRoomItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - meetingRoomCode: 98b6ea21a54c4c919fdcb89a50921869
                      meetingRoomName: 济人楼312
                    - meetingRoomCode: 98b6ea21a54c4c919fdcb89a50921857
                      meetingRoomName: 济人楼202
                    - meetingRoomCode: d2f89e1407054085b9c2afca55acf790
                      meetingRoomName: “驾驶舱”会议厅
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/teacher/send_user_types:
    get:
      operationId: v1_metadata_teacher_send_user_types
      summary: Dispatched-staff category code list
      description: '派遣人员类别 Original documented title: 派遣人员类别. Upstream system of record declared by the
        platform: SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问. Documentation
        last updated: 2026年06月09日 09时59分27秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/teacher_info/v1_metadata_teacher_send_user_types
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataTeacherSendUserTypesItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - sendUserTypeCode: '3'
                      sendUserTypeName: 双轨制
                    - sendUserTypeCode: '31'
                      sendUserTypeName: 双轨制(新)
                    - sendUserTypeCode: '2'
                      sendUserTypeName: 劳务派遣
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/teacher/status:
    get:
      operationId: v1_metadata_teacher_status
      summary: Faculty and staff employment status code list
      description: '教职工在校状态 Original documented title: 教职工在校状态. Upstream system of record declared by
        the platform: SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问.
        Documentation last updated: 2026年06月09日 09时21分04秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/teacher_info/v1_metadata_teacher_status
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataTeacherStatusItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - currentStatusCode: '99'
                      currentStatusName: 其他
                    - currentStatusCode: '16'
                      currentStatusName: 停薪
                    - currentStatusCode: '07'
                      currentStatusName: 离职
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/teacher/tech_job_code:
    get:
      operationId: v1_metadata_teacher_tech_job_code
      summary: Professional-technical post category code list
      description: '专业技术岗位类别 Original documented title: 专业技术岗位类别. Upstream system of record declared by
        the platform: SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问.
        Documentation last updated: 2026年06月09日 09时59分27秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/teacher_info/v1_metadata_teacher_tech_job_code
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataTeacherTechJobCodeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - isUseCode: '0'
                      isUseName: 否
                      techJobCode: '20001'
                      techJobName: 教学科研型
                      updateTime: '2022-05-24 00:00:00'
                    - isUseCode: '0'
                      isUseName: 否
                      techJobCode: '22001'
                      techJobName: 思政系列
                      updateTime: '2022-05-24 00:00:00'
                    - isUseCode: '1'
                      isUseName: 是
                      techJobCode: '10'
                      techJobName: 管理类
                      updateTime: '2022-05-24 00:00:00'
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/teacher/tech_job_level_code:
    get:
      operationId: v1_metadata_teacher_tech_job_level_code
      summary: Professional-technical post level code list
      description: '专业技术职务级别 Original documented title: 专业技术职务级别. Upstream system of record declared by
        the platform: SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问.
        Documentation last updated: 2026年06月09日 09时59分27秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/teacher_info/v1_metadata_teacher_tech_job_level_code
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataTeacherTechJobLevelCodeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - isUseCode: '1'
                      isUseName: 是
                      techJobLevelCode: '99'
                      techJobLevelName: 其他
                    - isUseCode: '1'
                      isUseName: 是
                      techJobLevelCode: '10'
                      techJobLevelName: 副科级
                    - isUseCode: '0'
                      isUseName: 否
                      techJobLevelCode: '123'
                      techJobLevelName: 正厅级
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/teacher/tech_level_of_workers_code:
    get:
      operationId: v1_metadata_teacher_tech_level_of_workers_code
      summary: Worker technical grade code list
      description: '工人技术等级 Original documented title: 工人技术等级. Upstream system of record declared by the
        platform: SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问. Documentation
        last updated: 2026年06月09日 09时59分27秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/teacher_info/v1_metadata_teacher_tech_level_of_workers_code
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataTeacherTechLevelOfWorkersCodeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - isUseCode: '1'
                      isUseName: 是
                      techLevelOfWorkersCode: '4'
                      techLevelOfWorkersName: 职业资格四级(中级)
                    - isUseCode: '1'
                      isUseName: 是
                      techLevelOfWorkersCode: '5'
                      techLevelOfWorkersName: 职业资格五级(初级)
                    - isUseCode: '1'
                      isUseName: 是
                      techLevelOfWorkersCode: '3'
                      techLevelOfWorkersName: 职业资格三级(高级)
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/teacher/title_code:
    get:
      operationId: v1_metadata_teacher_title_code
      summary: Appointed professional-technical title code list
      description: '聘任专业技术职务 Original documented title: 聘任专业技术职务. Upstream system of record declared by
        the platform: SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问.
        Documentation last updated: 2026年06月09日 09时59分28秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/teacher_info/v1_metadata_teacher_title_code
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataTeacherTitleCodeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - isUseCode: '1'
                      isUseName: 是
                      titleCode: '482'
                      titleName: 一级飞行通信员
                    - isUseCode: '1'
                      isUseName: 是
                      titleCode: '403'
                      titleName: 三级公证员
                    - isUseCode: '1'
                      isUseName: 是
                      titleCode: '154'
                      titleName: 助理编辑
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/teacher/types:
    get:
      operationId: v1_metadata_teacher_types
      summary: Faculty and staff personnel category code list
      description: '教职工人员类别 Original documented title: 教职工人员类别. Upstream system of record declared by
        the platform: SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问.
        Documentation last updated: 2026年06月09日 09时59分28秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/teacher_info/v1_metadata_teacher_types
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataTeacherTypesItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - userTypeCode: '10'
                      userTypeName: 编制类人员
                    - userTypeCode: '90'
                      userTypeName: 专职科研人员
                    - userTypeCode: '5'
                      userTypeName: 访问学者
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/user/person_idcard_type:
    get:
      operationId: v1_metadata_user_person_idcard_type
      summary: Identity-document type code list
      description: '人员证件类型 Original documented title: 人员证件类型. Authorization modes declared by the platform:
        无需授权可直接访问. Documentation last updated: 2026年06月09日 09时21分04秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/person_info/v1_metadata_user_person_idcard_type
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataUserPersonIdcardTypeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - cardCode: '01'
                      cardType: 居民身份证
                    - cardCode: '02'
                      cardType: 护照
                    - cardCode: '03'
                      cardType: 军官证
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v1/metadata/user/sex_code:
    get:
      operationId: v1_metadata_user_sex_code
      summary: Gender code list
      description: '性别 Original documented title: 性别. Upstream system of record declared by the platform:
        SYS20230025(同济大学人事系统). Authorization modes declared by the platform: 无需授权可直接访问. Documentation
        last updated: 2026年06月09日 09时34分33秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/person_info/v1_metadata_user_sex_code
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V1MetadataUserSexCodeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - sexCode: '0'
                      sexName: 未知的性别
                    - sexCode: '9'
                      sexName: 未说明的性别
                    - sexCode: '2'
                      sexName: 女
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v2/metadata/student/accom_building_code:
    get:
      operationId: v2_metadata_student_accom_building_code
      summary: Dormitory building code list
      description: '宿舍楼 Original documented title: 宿舍楼信息. Upstream system of record declared by the platform:
        SYS20250025(学生社区一站式服务管理信息系统). Authorization modes declared by the platform: 无需授权可直接访问. Documentation
        last updated: 2026年06月09日 09时59分28秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/property_info/v2_metadata_student_accom_building_code
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V2MetadataStudentAccomBuildingCodeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - accomBuildingCode: a0b05c9d98594cc5a435d304ffd9f832
                      accomBuildingName: 友园9号楼
                      accomRegionCode: '7'
                      accomRegionName: 嘉定校区
                      createTime: '2025-10-28T12:25:57'
                      isUseCode: '1'
                      isUseName: 是
                      updateTime: '2025-10-13T00:00:00'
                    - accomBuildingCode: a0b05c9d98594cc5a435d304ffd9f852
                      accomBuildingName: 桃李村13号
                      accomRegionCode: '2'
                      accomRegionName: 沪西校区
                      createTime: '2025-10-28T12:25:57'
                      isUseCode: '1'
                      isUseName: 是
                      updateTime: '2025-10-13T00:00:00'
                    - accomBuildingCode: a0b05c9d98594cc5a435d304ffd9f879
                      accomBuildingName: 生乐A区6号
                      accomRegionCode: '2'
                      accomRegionName: 沪西校区
                      createTime: '2025-10-28T12:25:57'
                      isUseCode: '1'
                      isUseName: 是
                      updateTime: '2025-10-13T00:00:00'
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
  /v2/metadata/student/accom_region_code:
    get:
      operationId: v2_metadata_student_accom_region_code
      summary: Dormitory region code list
      description: '宿舍区 Original documented title: 宿舍区信息. Upstream system of record declared by the platform:
        SYS20250025(学生社区一站式服务管理信息系统). Authorization modes declared by the platform: 无需授权可直接访问. Documentation
        last updated: 2026年06月09日 09时59分28秒.'
      tags:
      - Reference Metadata
      externalDocs:
        description: Tongji University Open Platform interface documentation (Chinese)
        url: https://api.tongji.edu.cn/docs/interface/metadata/property_info/v2_metadata_student_accom_region_code
      security: []
      x-anonymous-access: true
      responses:
        '200':
          description: Success. Envelope code A00000.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/V2MetadataStudentAccomRegionCodeItem'
              examples:
                live:
                  summary: Live response captured 2026-09-01 (truncated to three records)
                  value:
                    code: A00000
                    data:
                    - accomRegionCode: '8'
                      accomRegionName: 彰武路校区
                      createTime: null
                      isUseCode: '1'
                      isUseName: 是
                      updateTime: '2026-01-04T00:00:00'
                    - accomRegionCode: '2'
                      accomRegionName: 沪西校区
                      createTime: null
                      isUseCode: '1'
                      isUseName: 是
                      updateTime: '2026-01-04T00:00:00'
                    - accomRegionCode: '11'
                      accomRegionName: 东校区
                      createTime: '2026-08-05T05:07:41'
                      isUseCode: '1'
                      isUseName: 是
                      updateTime: '2026-08-04T00:00:00'
                    msg: 操作成功
        '429':
          description: Rate limit exceeded (default 50 requests per second per application per IP).
components:
  securitySchemes:
    openPlatformOAuth:
      type: oauth2
      description: 'OAuth 2.0 / OpenID Connect issued by the Open Platform Keycloak realm. Discovery document:
        https://api.tongji.edu.cn/keycloak/realms/OpenPlatform/.well-known/openid-configuration (HTTP
        200, verified 2026-09-01). Access tokens default to 7200 seconds and are sent as Authorization:
        Bearer <access_token>.'
      flows:
        clientCredentials:
          tokenUrl: https://api.tongji.edu.cn/keycloak/realms/OpenPlatform/protocol/openid-connect/token
          refreshUrl: https://api.tongji.edu.cn/keycloak/realms/OpenPlatform/protocol/openid-connect/token
          scopes: {}
        authorizationCode:
          authorizationUrl: https://api.tongji.edu.cn/keycloak/realms/OpenPlatform/protocol/openid-connect/auth
          tokenUrl: https://api.tongji.edu.cn/keycloak/realms/OpenPlatform/protocol/openid-connect/token
          refreshUrl: https://api.tongji.edu.cn/keycloak/realms/OpenPlatform/protocol/openid-connect/token
          scopes:
            openid: OpenID Connect subject identity.
            offline_access: Refresh-token issuance.
            profile: Profile claims.
            email: Email claim.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'The access_token obtained from the Keycloak realm, presented as Authorization: Bearer
        <access_token>.'
  schemas:
    Envelope:
      type: object
      description: Standard Tongji Open Platform response envelope. Every interface returns code, data
        and msg.
      properties:
        code:
          type: string
  

# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tongji/refs/heads/main/openapi/tongji-reference-metadata-openapi.yml