ga4gh-discovery / ga4gh-service-info

GA4GH service-info specification.
Apache License 2.0
9 stars 8 forks source link

schemaUrl to document the API schema used by the service #26

Open susheel opened 5 years ago

susheel commented 5 years ago

I feel it may be worth adding the explicit URL to the API schema used by the service. This would allow clients to detect the API schema used by the service and self-configure. This could point to the GA4GH YAML spec or a local copy that may add non-breaking extensions. See example below:

schemaUrl:
  type: string
  description: URL of the schema of this service (RFC 3986 format).

Related GA4GH DRS /service-info PR #277 discussion.