Tsinghua University · API Governance Rules

Tsinghua University API Rules

Spectral linting rules defining API design standards and conventions for Tsinghua University.

5 Rules error 2 warn 3

View Rules File View on GitHub

Rule Categories

tsinghua

Rules

warn

tsinghua-info-contact

API info should include a contact for the TUNA association.

$.info

warn

tsinghua-info-license

API info should declare a license.

$.info

error

tsinghua-operation-id

Every operation must have an operationId.

$.paths[*][*]

error

tsinghua-status-enum

Mirror status must constrain values to the known tunasync states.

$.components.schemas.MirrorStatus.properties.status

warn

tsinghua-timestamp-int64

Unix epoch timestamp fields should use integer int64 format.

$.components.schemas.MirrorStatus.properties[?(@property.match(/_ts$/))]

Spectral Ruleset

extends: spectral:oas
formats:
  - oas3
rules:
  tsinghua-info-contact:
    description: API info should include a contact for the TUNA association.
    given: $.info
    severity: warn
    then:
      field: contact
      function: truthy
  tsinghua-info-license:
    description: API info should declare a license.
    given: $.info
    severity: warn
    then:
      field: license
      function: truthy
  tsinghua-operation-id:
    description: Every operation must have an operationId.
    given: $.paths[*][*]
    severity: error
    then:
      field: operationId
      function: truthy
  tsinghua-status-enum:
    description: Mirror status must constrain values to the known tunasync states.
    given: $.components.schemas.MirrorStatus.properties.status
    severity: error
    then:
      field: enum
      function: truthy
  tsinghua-timestamp-int64:
    description: Unix epoch timestamp fields should use integer int64 format.
    given: $.components.schemas.MirrorStatus.properties[?(@property.match(/_ts$/))]
    severity: warn
    then:
      - field: type
        function: pattern
        functionOptions:
          match: '^integer$'
      - field: format
        function: pattern
        functionOptions:
          match: '^int64$'

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/tsinghua-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.