University of Edinburgh

University of Edinburgh Status API

Service status

GitHub OpenAPI

Documentation

📖
Documentation
https://libraryblogs.is.ed.ac.uk/datablog/2021/12/17/new-feature-in-edinburgh-datashare-the-rest-api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/university-of-edinburgh/refs/heads/main/openapi/university-of-edinburgh-status-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/university-of-edinburgh/refs/heads/main/json-schema/university-of-edinburgh-item-schema.json

Other Resources

🔗
x-json-structure
https://raw.githubusercontent.com/api-evangelist/university-of-edinburgh/refs/heads/main/json-structure/university-of-edinburgh-item-structure.json
🔗
x-examples
https://raw.githubusercontent.com/api-evangelist/university-of-edinburgh/refs/heads/main/examples/university-of-edinburgh-getItem-example.json
🔗
x-spectral-rules
https://raw.githubusercontent.com/api-evangelist/university-of-edinburgh/refs/heads/main/rules/university-of-edinburgh-rules.yml
🔗
x-vocabulary
https://raw.githubusercontent.com/api-evangelist/university-of-edinburgh/refs/heads/main/vocabulary/university-of-edinburgh-vocabulary.yml
🔗
x-json-ld-context
https://raw.githubusercontent.com/api-evangelist/university-of-edinburgh/refs/heads/main/json-ld/university-of-edinburgh-context.jsonld

OpenAPI Specification

university-of-edinburgh-status-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Edinburgh DataShare REST Bitstreams Status API
  description: Public read-only DSpace 6 legacy REST API for Edinburgh DataShare, the University of Edinburgh's open-access research-data repository. Allows programmatic querying of communities, collections, items, bitstreams and the metadata/schema registry. Responses are JSON. This specification was reconstructed from the live API index at https://datashare.ed.ac.uk/rest and verified against live responses; only the documented public GET endpoints are described here.
  version: 6.x
  contact:
    name: Edinburgh DataShare
    url: https://datashare.ed.ac.uk/
  license:
    name: DSpace BSD License
    url: https://github.com/DSpace/DSpace/blob/dspace-6_x/LICENSE
servers:
- url: https://datashare.ed.ac.uk/rest
  description: Edinburgh DataShare production REST endpoint
tags:
- name: Status
  description: Service status
paths:
  /test:
    get:
      tags:
      - Status
      summary: Health check
      description: Returns the string "REST api is running." for testing purposes.
      operationId: getTest
      responses:
        '200':
          description: Service is running.
          content:
            text/plain:
              schema:
                type: string
                example: REST api is running.