Allow swagger-like component

[coyotte508]

Allow a component to host a swagger UI, to better document endpoints & also be able to directly call endpoints from the browser.

It would be useful for this page: https://huggingface.co/docs/hub/api

See also huggingface/hub-docs#348

I'm not sure but think this repo is probably the one to add the functionality to? We'll also be able to use the component for datasets-server, for example (cc @severo)

[severo]

For reference, we host the OpenAPI (new name of the swagger standard) specification here: https://datasets-server.huggingface.co/openapi.json and we use the online demo of ReDoc to show it: https://redocly.github.io/redoc/?url=https://datasets-server.huggingface.co/openapi.json.
Additionally, we provide the same endpoints in https://www.postman.com/huggingface/workspace/hugging-face-apis/documentation/23242779-d068584e-96d1-4d92-a703-7cb12cbd8053 and https://rapidapi.com/hugging-face-hugging-face-default/api/hugging-face-datasets-api/ because:

• they provide a better UX
• possibly, they can help discovery through their respective catalogs

It's not ideal because none of the three are synchronized, and every change in the API must be updated in the three locations.

[coyotte508]

I looked at redoc: https://www.npmjs.com/package/redoc

It's nicer UX than Swagger-UI but the "try it" functionality is not open-source: Redocly/redoc#53 (comment)

So I'm going to try Swagger UI

[severo]

Related: I wanted to have the file https://github.com/huggingface/datasets-server/blob/7b51acfce7005839a50a113d561f526eeef043ad/chart/static-files/openapi.json served by the docs (huggingface/dataset-viewer#849). But it seems like it's not possible to copy static files. What would be the best way to do it?