Imperial College London · API Governance Rules

Imperial College London API Rules

Spectral linting rules defining API design standards and conventions for Imperial College London.

6 Rules error 3 warn 2 info 1

View Rules File View on GitHub

Rule Categories

spiral

Rules

error

spiral-info-version-present

API info must declare a version (DSpace release).

$.info

warn

spiral-server-uses-server-api-base

Servers should use the DSpace /server/api base path.

$.servers[*].url

error

spiral-operations-have-operationid

Every operation must have an operationId.

$.paths[*][get,post,put,patch,delete]

warn

spiral-uuid-path-params-are-uuid-format

Path parameters named uuid must declare format uuid.

$.paths[*][*].parameters[?(@.in=='path' && @.name=='uuid')].schema

info

spiral-responses-are-hal-json

200 responses should be served as application/hal+json (DSpace HAL).

$.paths[*][get].responses.200.content

error

spiral-metadata-value-shape

A metadataValue object must always carry a value field.

$.components.schemas.MetadataValue

Spectral Ruleset

# Provenance — API Evangelist university pipeline, 2026-08-19.
x-generated: '2026-08-19'
x-method: generated
x-source: live probe of https://spiral.imperial.ac.uk/server/api (DSpace 7.6.1 / DSpace-CRIS 2023.02.05)
x-operator: tenant
x-operator-note: >-
  Derived from the Spiral DSpace-CRIS contract. Per the university pipeline's inheritance rule,
  everything derived from a tenant-operated contract inherits that operator: the platform is
  4Science-hosted DSpace, the data is Imperial's.
formats:
  - oas3
rules:
  spiral-info-version-present:
    description: API info must declare a version (DSpace release).
    severity: error
    given: $.info
    then:
      field: version
      function: truthy
  spiral-server-uses-server-api-base:
    description: Servers should use the DSpace /server/api base path.
    severity: warn
    given: $.servers[*].url
    then:
      function: pattern
      functionOptions:
        match: "/server/api$"
  spiral-operations-have-operationid:
    description: Every operation must have an operationId.
    severity: error
    given: $.paths[*][get,post,put,patch,delete]
    then:
      field: operationId
      function: truthy
  spiral-uuid-path-params-are-uuid-format:
    description: Path parameters named uuid must declare format uuid.
    severity: warn
    given: $.paths[*][*].parameters[?(@.in=='path' && @.name=='uuid')].schema
    then:
      field: format
      function: pattern
      functionOptions:
        match: "^uuid$"
  spiral-responses-are-hal-json:
    description: 200 responses should be served as application/hal+json (DSpace HAL).
    severity: info
    given: $.paths[*][get].responses.200.content
    then:
      field: "application/hal+json"
      function: truthy
  spiral-metadata-value-shape:
    description: A metadataValue object must always carry a value field.
    severity: error
    given: $.components.schemas.MetadataValue
    then:
      field: required
      function: truthy

Work with this as data

Every ruleset here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for spectral rules

4 MCP tools reach this

find_rulesBrowse and filter every ruleset in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This ruleset

curl "https://apis.io/api/v1/rules/imperial-college-london-rules"

All spectral rules

curl "https://apis.io/api/v1/rules?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.