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

Hong Kong Baptist University concept API

The concept API from Hong Kong Baptist University — 4 operation(s) for concept.

Hong Kong Baptist University concept API is one of 34 APIs that Hong Kong Baptist University publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include concept. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 3 JSON Schemas.

This API exposes 4 operations across 4 paths, and defines 12 schemas. It is described by OpenAPI 3.0.1, at version 5.35.0.

Requests are made against a single base URL, https://scholars.hkbu.edu.hk/ws/api.

4 operations 4 paths 12 schemas 3 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
5.35.0
Base URL
https://scholars.hkbu.edu.hk/ws/api/
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Hong Kong Baptist University concept API declares 1 security scheme for authenticating requests. An API key is passed in the header as api-key (api-key). By default, every request must be authenticated.

  • api-key — Security mechanism for the API

Paths & Operations 4

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

concept 4
GET
/concepts
Lists all concept
concept_list 3 params → 200
GET
/concepts/allowed-locales
A list of allowed locales in localized strings
concept_getAllowedLocales → 200
POST
/concepts/search
Query operation for concept
concept_query body → 200400
GET
/concepts/{uuid}
Get concept
concept_get 1 param → 200301404

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are Concept (18 properties), ConceptQuery (6 properties), ProblemDetails (5 properties), Term (3 properties). Each schema is shown below with its type and property counts.

Concept
object
A concept
18 properties 2 required
ThesaurusRef
object
A reference to a thesaurus
1 required
PageInformation
object
Information about pages
2 properties
Identifier
object
1 property 1 required
ProblemDetails
object
RFC7807 Error details
5 properties
LocalesList
object
List of available locales
1 property
LocalizedString
object
A set of string values, one for each submission locale. Note: invalid locale values will be ignored.
ConceptRef
object
A reference to a concept
1 required
ConceptQuery
object
Create a query for concept
6 properties
Term
object
A term
3 properties 1 required
ContentRef
object
2 properties 2 required
ConceptListResult
object
List of concept. Can contain a subset of all items along with the full count
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hong-kong-baptist-university-concept-api-openapi.yml Raw ↑

Other APIs Hong Kong Baptist University publishes across the network.

HKBU Mobile App Backend (gated)
Hong Kong Baptist University activity API
Hong Kong Baptist University application API
Hong Kong Baptist University authorCollaboration API
Hong Kong Baptist University award API
Hong Kong Baptist University classificationScheme API
Hong Kong Baptist University course API
Hong Kong Baptist University dataSet API
Hong Kong Baptist University education API
Hong Kong Baptist University equipment API
Hong Kong Baptist University ethicalReview API
Hong Kong Baptist University event API