drf-yasg VS drf-nested-routers

I believe drf-yasg what you need. You can create a schema manually and define request and response types for your small API.

Check this out: https://drf-yasg.readthedocs.io/en/stable/

There's also the caveat of having different API documentation for both the frontend solution and the API-only solution, since I don't want to expose the frontend-specific endpoints to the API-only endpoints, but I think that might just take some time playing around with swagger: https://drf-yasg.readthedocs.io/en/stable/

Swagger and OpenAPI capabilities using drf-yasg, where you can only see endpoints and Swagger docs if you have a valid Token

The major apps are news and accounts. While the former handles almost all the physical functionalities of the system, the latter only does user stuff. The api app exposes the data for consumption. It is documented using drf-yasg, a Swagger generation tool implemented without using the schema generation provided by Django Rest Framework. The api has a token-based authentication which requires that all POST requests must provide a token to be accepted, otherwise a not too interesting response:

Our RESTful API was actually the easiest to document, because we were able to rely on third-party libraries from the start. It was a Python Django and Django REST Framework project that leveraged the drf-yasg OpenAPI generator library to create OpenAPI and Swagger compatible documentation.

This post will go through how to document your DRF APIs using https://github.com/axnsan12/drf-yasg/ package.

I suggest that you use the drf nested routes package.

This worked for me https://github.com/alanjds/drf-nested-routers

What is the status and reliability of https://github.com/alanjds/drf-nested-routers? Is is stable enough for production and to commit effort into using it?

ViewSets don't rule out nested data but it does take more work. I use https://github.com/alanjds/drf-nested-routers in places where I need nested viewsets.

If you're using Django Rest Framework, you may also want to look into drf-nested-routers. This is a package that makes routes like /parent/:parent_id/child/ easier to do.

According to the docs, the drf-nested-routers package is the way to handle this. The docs also made it look extremely simple to use, but I must be missing something, as I get a "Page Not Found" error.

I looked at a couple DRF nested resource libraries (drf-extensions and drf-nested-routers) but found them to be overkill.