50 lines
1.2 KiB
Markdown
50 lines
1.2 KiB
Markdown
|
# 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 '{
|
|||
|
|
...
|
|||
|
|
}'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|