Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Harbin Institute of Technology person API

The person API from Harbin Institute of Technology — 5 operation(s) for person.

Harbin Institute of Technology person API is one of 3 APIs that Harbin Institute of Technology publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include person. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

This API exposes 8 operations across 5 paths, and defines 2 schemas. It is described by OpenAPI 3.0.3, at version 5.35.3-4.

Requests are made against a single base URL, https://scholar.hit.edu.cn/ws/api.

8 operations 5 paths 2 schemas 1 DELETE4 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
5.35.3-4
Base URL
https://scholar.hit.edu.cn/ws/oai
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Harbin Institute of Technology person API declares 1 security scheme for authenticating requests. An API key is passed in the header as api-key (apiKey). By default, every request must be authenticated.

  • apiKey — Pure API key. The HIT instance requires an issued key for API access.

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 1 DELETE, 4 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

person 8
GET
/persons
Lists all persons
person_list 3 params → 200
PUT
/persons
Create person
person_create → 201400
POST
/persons/search
Query operation for persons
person_query → 200400
GET
/persons/{uuid}
Get person
person_get 1 param → 200301404
PUT
/persons/{uuid}
Update person
person_update 1 param → 200400404409
DELETE
/persons/{uuid}
Delete person
person_delete 1 param → 204404409
GET
/persons/allowed-main-research-areas
A list of allowed main research areas
person_getAllowedMainResearchAreas → 200
GET
/persons/orderings
Lists available orderings
person_getOrderings → 200

Schemas 2

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

Person
object
An academic professional, student, or other individual attached to the institution.
51 properties
PersonListResult
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

harbin-institute-of-technology-person-api-openapi.yml Raw ↑

Other APIs Harbin Institute of Technology publishes across the network.

HIT Research Portal RSS Feeds
Harbin Institute of Technology researchOutput API