Commenting style guide for restful apis in django / flask

Question

Is there any de-facto commenting style for restful api classes or functions? If there’s no such, then how do I apply google / sphinx commenting style to rest apis?

For example, how do I write comment for

class MyListAPI(APIView):
    def get(self, request, **kwargs):
        ...

if the api takes some query string parameters?

Asked By: June

||

Source

Answer 1

You can check out Swagger extension for flask or Django

Swagger can generate html page for docs and testing.

You can also look at:

Answered By: Cyrbil

Commenting style guide for restful apis in django / flask

Question:

Answers: