doc: improve the doc of API endpoints
make usage of the sphinx-httpdomain extension according to its documenation.