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

Imperial College London Core API

Communities, collections, and items.

Imperial College London Core API is one of 4 APIs that Imperial College London publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Core. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 6 paths, and defines 9 schemas. It is described by OpenAPI 3.0.3, at version 7.6.1.

Requests are made against a single base URL, https://spiral.imperial.ac.uk/server/api.

6 operations 6 paths 9 schemas 6 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
7.6.1
Server
https://spiral.imperial.ac.uk/server/api
Resource Areas
1

Paths & Operations 6

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

Core 6

Communities, collections, and items.

GET
/core/communities
List top-level and all communities
getCommunities 2 params → 200
GET
/core/communities/{uuid}
Get a single community by UUID
getCommunity 1 param → 200404
GET
/core/collections
List collections
getCollections 2 params → 200
GET
/core/collections/{uuid}
Get a single collection by UUID
getCollection 1 param → 200404
GET
/core/items/{uuid}
Get a single item by UUID
getItem 1 param → 200404
GET
/dso/find
Find a DSpaceObject by UUID
dsoFind 1 param → 200404

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are DSpaceObject (7 properties), MetadataValue (5 properties), PageInfo (4 properties), HalPage (3 properties). Each schema is shown below with its type and property counts.

MetadataMap
object
Map of Dublin Core / DSpace metadata field keys (e.g. dc.title, dc.contributor.author) to arrays of metadata values.
PageInfo
object
4 properties
HalPage
object
3 properties
Collection
Item
Community
DSpaceObject
object
7 properties
MetadataValue
object
A single metadata field value in DSpace's metadata model.
5 properties 1 required
CommunityPage

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

imperial-college-london-core-api-openapi.yml Raw ↑

Other APIs Imperial College London publishes across the network.

Imperial Shibboleth Identity Provider (SAML 2.0)
Imperial College London Discover API
Imperial College London Root API