Embed swagger API documentation in CKAN

Is there a way to embed API documentation in CKAN or should I just link to an external site?

E.G.

API in CKAN https://data.qld.gov.au/dataset/qld-wildlife-data-api

Sample Swagger documentation http://petstore.swagger.io

2 Likes

Hi @Stephen, there is no out of the box way of embedding a Swagger spec but linking to it as a resource sounds like a good approach.

2 Likes

Just found this extension from the Province of British Columbia

It’s a resource viewer for Swagger (aka OpenAPI) basically:

https://catalogue.data.gov.bc.ca/dataset/workbc-job-postings-api-web-service

And the API specs themselves are stored on this repo:

2 Likes