discoverable and browseable REST API

[mpdehaan]

I notice right now that when running the very first basic demos the root of the web API is not discoverable so you can find other resources. While this is a start, having an index like ...

{
"comments" : "/api/comments/",
"users" : "/api/users/",
}

Is not all you can do. Django REST Framework had an amazing example with https://www.django-rest-framework.org/topics/browsable-api/ where you can PUT and POST from the web inteface, and everything is browseable hyperlinks

An API that is web-surfable makes an amazing demo and would be very good to show in the core documentation, videos, tutorials, and so on.

It really helps out when people are writing integrations against an API too.

[penberg]

@mpdehaan One option is to implement OpenAPI support and then integrate with Swagger. What are your thoughts on this?