身份认证
认证方式
SMS客服管理系统使用Bearer Token进行API认证。所有API请求（除登录外）都需要在请求头中包含有效的访问令牌：
Authorization: Bearer <your_access_token>
POST
/api/auth/login
用户登录接口，成功后返回访问令牌。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | string | 是 | 用户名 |
| password | string | 是 | 密码 |
响应示例
{
"success": true,
"message": "Login successful",
"data": {
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
"user": {
"id": 1,
"username": "admin",
"name": "管理员",
"role": "admin"
}
}
}
发送短信
POST
/api/sms/send
发送单条短信消息。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| to | string | 是 | 接收者手机号 |
| message | string | 是 | 短信内容 |
响应示例
{
"success": true,
"message": "SMS sent successfully",
"data": {
"sms_id": "sms_65872b4c8f1a2",
"to": "13800138000",
"status": "sent",
"cost": 0.05
}
}
群发短信
POST
/api/sms/bulk
批量发送短信到多个接收者。
请求示例
{
"recipients": [
{"phone": "13800138000", "name": "张三"},
{"phone": "13800138001", "name": "李四"}
],
"message": "您好{name}，这是测试短信。"
}
短信列表
GET
/api/sms
获取短信记录列表，支持分页和筛选。
对话列表
GET
/api/conversations
获取对话记录列表。
模板列表
GET
/api/templates
获取短信模板列表。
用户列表
GET
/api/users
获取用户列表（需要管理员权限）。
健康检查
GET
/api/health
检查系统健康状态。
数据导出
GET
/api/export/list
获取可导出文件列表。