基础查询API
用于查询指定QQ号的名片赞数量，是最基础的API接口。
请求示例：
GET /api/v1/praise-count?qq=123456789 HTTP/1.1
Host: api.mingpianzan.com
Authorization: Bearer YOUR_API_KEY
响应示例：
{
"code": 0,
"message": "success",
"data": {
"qq": "123456789",
"praise_count": 2560,
"update_time": "2023-10-15 14:30:45"
}
}
参数说明：
- qq: 需要查询的QQ号码，必填
- Authorization: Bearer token，必填
返回值说明：
- code: 响应状态码，0表示成功
- message: 响应消息
- data.qq: 查询的QQ号码
- data.praise_count: 名片赞数量
- data.update_time: 数据更新时间
批量查询API
用于一次性查询多个QQ号的名片赞数量，提高查询效率。
请求示例：
POST /api/v1/batch-praise-count HTTP/1.1
Host: api.mingpianzan.com
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"qq_list": ["123456789", "987654321", "456789123"]
}
响应示例：
{
"code": 0,
"message": "success",
"data": [
{
"qq": "123456789",
"praise_count": 2560,
"update_time": "2023-10-15 14:30:45"
},
{
"qq": "987654321",
"praise_count": 1840,
"update_time": "2023-10-15 14:31:02"
},
{
"qq": "456789123",
"praise_count": 3205,
"update_time": "2023-10-15 14:31:20"
}
]
}
参数说明：
- qq_list: QQ号码列表，最多支持100个QQ号
- Authorization: Bearer token，必填
返回值说明：
- code: 响应状态码，0表示成功
- message: 响应消息
- data: 数组，包含每个QQ号的查询结果
历史数据API
用于查询指定QQ号在特定时间段内的名片赞数量历史记录。
请求示例：
GET /api/v1/praise-history?qq=123456789&start_date=2023-10-01&end_date=2023-10-15 HTTP/1.1
Host: api.mingpianzan.com
Authorization: Bearer YOUR_API_KEY
响应示例：
{
"code": 0,
"message": "success",
"data": {
"qq": "123456789",
"history": [
{
"date": "2023-10-01",
"praise_count": 1500
},
{
"date": "2023-10-02",
"praise_count": 1520
},
...
{
"date": "2023-10-15",
"praise_count": 2560
}
]
}
}
参数说明：
- qq: 需要查询的QQ号码，必填
- start_date: 开始日期，格式YYYY-MM-DD，必填
- end_date: 结束日期，格式YYYY-MM-DD，必填
- Authorization: Bearer token，必填
返回值说明：
- code: 响应状态码，0表示成功
- message: 响应消息
- data.qq: 查询的QQ号码
- data.history: 历史数据数组，包含日期和对应的点赞数
数据分析API
用于分析指定QQ号的名片赞数量变化趋势，并提供相关统计信息。
请求示例：
GET /api/v1/praise-analysis?qq=123456789&days=30 HTTP/1.1
Host: api.mingpianzan.com
Authorization: Bearer YOUR_API_KEY
响应示例：
{
"code": 0,
"message": "success",
"data": {
"qq": "123456789",
"period": "30天",
"current_count": 2560,
"average_count": 1980,
"max_count": 2560,
"min_count": 1500,
"growth_rate": 15.2,
"trend": "上升",
"analysis": "该QQ名片点赞数量呈稳定增长趋势，日均增长约35.3个点赞"
}
}
参数说明：
- qq: 需要查询的QQ号码，必填
- days: 分析天数，范围1-365，必填
- Authorization: Bearer token，必填
返回值说明：
- code: 响应状态码，0表示成功
- message: 响应消息
- data.qq: 查询的QQ号码
- data.period: 分析周期
- data.current_count: 当前点赞数量
- data.average_count: 平均点赞数量
- data.max_count: 最高点赞数量
- data.min_count: 最低点赞数量
- data.growth_rate: 增长率(%)
- data.trend: 趋势("上升"或"下降")
- data.analysis: 分析结果