Initial commit

reference/goedge 文档/ServerRegionCityMonthlyStatService.md

@@ -0,0 +1,49 @@
+# ServerRegionCityMonthlyStatService
+> 城市月份统计
+
+---
+
+## findTopServerRegionCityMonthlyStats
+> 查找前N个城市
+
+- 角色：`admin`, `user`
+- HTTP：`POST https://backend.dooki.cloud/ServerRegionCityMonthlyStatService/findTopServerRegionCityMonthlyStats`
+- RPC：`rpc findTopServerRegionCityMonthlyStats (FindTopServerRegionCityMonthlyStatsRequest) returns (FindTopServerRegionCityMonthlyStatsResponse);`
+
+**请求对象 (`FindTopServerRegionCityMonthlyStatsRequest`)**
+
+```json
+{
+  "month": "string // YYYYMM",
+  "serverId": "int64 // 服务ID（网站ID）",
+  "countryId": "int64",
+  "provinceId": "int64",
+  "offset": "int64 // 读取位置",
+  "size": "int64 // 数量，通常不能小于0"
+}
+```
+
+**响应对象 (`FindTopServerRegionCityMonthlyStatsResponse`)**
+
+```json
+{
+  "stats": "[]Stat",
+  "regionCountry": "RegionCountry",
+  "regionProvince": "RegionProvince",
+  "regionCity": "RegionCity",
+  "count": "int64 // 数量"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/ServerRegionCityMonthlyStatService/findTopServerRegionCityMonthlyStats" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---