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
• D2.2 and D2.4 reports to the EU describing the thinking behind the choice of OpenAPI and Json-LD. Note: the second of these is not yet approved and only accessible by project members

TODO - add links to other related docs.

Examples

• The BridgeDb Notebook
• Modelling IC50 results

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