Include dev API in docs

[PeterPetrik]

if we have swagger definition of the public REST API it should be possible to easily create nice documentation for anyone who would like to use it for custom integrations

[PeterPetrik]

This would be really good to focus on ... how difficult it is to add v2 REST API to docs? it is kindof requested - see https://www.linkedin.com/posts/peter-petrik_gis-rest-python-activity-7300515410368491520-HFBh?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAVXwugBSyHsujw32KkjNmhhuMbGtf3Vhu4

cc @MarcelGeo @varmar05 @alex-cit