Writing OpenAPI and JSON LD descriptors

Background

Services should be REST web services described using OpenAPI 3.0 (Swagger) descriptors, annotation with ontological definitions defined using JSON-LD.

• Open API 3.0 Specification
• JSON-LD

TODO - add links to relevant ORN reports and other related docs.

Examples

• The BridgeDb Notebook
• Modelling IC50 results

TODO - provide other links and guidance to how to annotate your services.