How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

USTC Campus Enrollment Status Query API (在校状态查询接口)

A small, precise, institution-authored REST API that resolves a person's campus enrollment status code by global person identifier or identity number, singly or in batches of up to 100. USTC publishes it in prose with a field table, response examples, curl invocations and an enumerated error table that distinguishes a missing token (401) from a valid token off the IP allowlist (403). It requires both an administrator-issued bearer token and a registered source IP, and USTC says outright that it is not for browser users. The health check is public and returns 200. An OpenAPI 3.1 description is DERIVED here from USTC's own documentation; USTC publishes no machine-readable contract itself.

USTC Campus Enrollment Status Query API (在校状态查询接口) is one of 6 APIs that University of Science and Technology of China publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Identity, Student Records, Enrollment, and Gated. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 1 JSON Schema.

This API exposes 5 operations across 5 paths, organized into 2 resource areas, and defines 9 schemas. It is described by OpenAPI 3.1.0, at version 2026-08-30.

Requests are made against a single base URL, https://id.ustc.edu.cn/doc/api.

5 operations 5 paths 9 schemas 3 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026-08-30
Base URL
https://id.ustc.edu.cn/doc/api
Authentication
HTTP Bearer
Resource Areas
2

Authentication & Security 1

USTC Campus Enrollment Status Query API (在校状态查询接口) declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerToken). By default, every request must be authenticated.

  • bearerToken — Administrator-issued token, sent as Authorization: Bearer . USTC additionally enforces a source-IP allowlist registered at onboarding; both conditions must hol…

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 3 GET, 2 POST. They span 2 resource areas: Health, Status. Each is listed below with its method, path, parameters, and response codes.

Health 1

Unauthenticated liveness check.

GET
/health
Health check
getHealth → 200
Status 4

Enrollment status lookup by person identifier.

GET
/status/by-gid/{gid}
Query enrollment status by gid
getStatusByGid 1 param → 200401403404500
GET
/status/by-zjhm/{zjhm}
Query enrollment status by zjhm
getStatusByZjhm 1 param → 200401403404500
POST
/status/by-gids
Batch query enrollment status by gid
batchStatusByGid body → 200400401403500
POST
/status/by-zjhms
Batch query enrollment status by zjhm
batchStatusByZjhm body → 200400401403500

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are ZjhmResult (3 properties), GidResult (2 properties), StatusItem (2 properties), ZjhmBatchResult (2 properties). Each schema is shown below with its type and property counts.

Health
object
1 property 1 required
StatusItem
object
One identity and its enrollment status code.
2 properties 2 required
GidResult
object
2 properties 2 required
ZjhmResult
object
3 properties 3 required
GidBatchRequest
object
1 property 1 required
ZjhmBatchRequest
object
1 property 1 required
GidBatchResult
object
2 properties 2 required
ZjhmBatchResult
object
2 properties 2 required
Error
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ustc-campus-status-api-openapi.yml Raw ↑

Other APIs University of Science and Technology of China publishes across the network.

USTC Unified Identity Authentication (id.ustc.edu.cn, formerly Passport SSO)
USTC Shibboleth Identity Provider (跨校资源认证中心)
USTC Course Catalog API (catalog.ustc.edu.cn)
USTC Open Source Software Mirror
USTC Campus GitLab
Where this information came from

This is an independent, third-party profile of USTC Campus Enrollment Status Query API (在校状态查询接口), published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.