# University of Hong Kong Discovery API

**Canonical:** https://apis.io/apis/hku/hku-discovery-api/  
**Provider:** University of Hong Kong — https://apis.io/providers/hku/  
**Base URL:** https://hkafidp.hku.hk/idp/shibboleth  
**Documentation:** https://www.hkaf.edu.hk/

University of Hong Kong Discovery API is one of 8 APIs that [University of Hong Kong](https://apis.io/providers/hku/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Discovery. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, and 1 JSON Schema.

Metadata documents that describe the identity service.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/adfs/.well-known/openid-configuration` | OpenID Connect discovery document |
| GET | `/adfs/discovery/keys` | JSON Web Key Set |
| GET | `/FederationMetadata/2007-06/FederationMetadata.xml` | WS-Federation / SAML 2.0 federation metadata |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hku/refs/heads/main/openapi/hku-discovery-api-openapi.yml
- **WellKnown** — https://raw.githubusercontent.com/api-evangelist/hku/refs/heads/main/well-known/hku-adfs-openid-configuration.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hku/refs/heads/main/json-schema/hku-openid-configuration.schema.json
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/hku/refs/heads/main/scopes/hku-scopes.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/hku/refs/heads/main/authentication/hku-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/hku/refs/heads/main/errors/hku-errors.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/hku/refs/heads/main/examples/hku-identity-examples.yml

## Other University of Hong Kong APIs (7)

- [HKU Shibboleth Identity Provider](https://apis.io/apis/hku/identity-federation/)
- [HKU ITS API Developer Portal and Gateway](https://apis.io/apis/hku/its-api-portal/)
- [HKU Scholars Hub OAI-PMH](https://apis.io/apis/hku/scholars-hub-oai/)
- [HKU DataHub (Figshare tenancy)](https://apis.io/apis/hku/datahub-figshare/)
- [HKU Libraries Discovery (Ex Libris Primo tenancy)](https://apis.io/apis/hku/library-primo/)
- [HKU Microsoft Entra ID Tenant](https://apis.io/apis/hku/entra-tenant/)
- [University of Hong Kong O Auth API](https://apis.io/apis/hku/hku-oauth-api/)

## Tags

Discovery

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hku/hku-discovery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hku/.