GO-4459: REST API Docs & Refinement

.run/Run.run.xml

@@ -9,6 +9,7 @@
       <env name="ANYTYPE_GATEWAY_ADDR" value="127.0.0.1:31006" />
       <env name="ANYTYPE_GRPC_ADDR" value="127.0.0.1:31007" />
       <env name="ANYTYPE_GRPCWEB_ADDR" value="127.0.0.1:31008" />
+      <env name="ANYTYPE_API_DEBUG" value="1" />
       <env name="CC" value="/usr/bin/cc" />
       <env name="CXX" value="/usr/bin/c++" />
       <env name="CGO_CFLAGS" value="-Wno-deprecated-declarations -Wno-deprecated-non-prototype -Wno-xor-used-as-pow" />

Makefile

@@ -338,6 +338,12 @@ else
 	@golangci-lint run -v ./... --new-from-rev=origin/main --timeout 15m --fix
 endif
 
+swagger:
+	@echo 'Generating swagger docs...'
+	@swag init --v3.1 -q -d core/api -g service.go -o core/api/docs
+	@echo 'Formatting swagger docs...'
+	@swag fmt -d core/api
+
 ### Tantivy Section
 
 REPO := anyproto/tantivy-go