nepiedg
2884f54666
- Revised README.md to provide a clearer documentation structure for multiple mini programs, including a new table of contents. - Added references to common authentication documentation in both the remove watermark API and README files. - Improved clarity of the login interface description and error handling messages in the remove watermark API documentation.
1.3 KiB
1.3 KiB
认证与登录
1) 登录
POST /api/v1/auth/login
说明：小程序端调用 wx.login() 获取 code，后端用该 code 向微信 jscode2session 换取 openid/session_key，并在数据库中创建/更新用户记录。
请求示例：
curl -X POST 'http://127.0.0.1:8080/api/v1/auth/login' \
-H 'Content-Type: application/json' \
-d '{
"mini_program_id": 1,
"code": "wx.login 返回的 code",
"nickname": "可选：昵称",
"avatar_url": "可选：头像",
"gender": 1,
"phone": "可选：手机号"
}'
成功响应示例（节选）：
{
"code": 200,
"message": "success",
"data": {
"user": {
"id": 1,
"mini_program_id": 1,
"open_id": "oXXX",
"nickname": "昵称",
"avatar_url": "https://...",
"gender": 1,
"phone": "110"
},
"session_key": "wx-session-key",
"mini_program": {
"id": 1,
"name": "某小程序",
"app_id": "wx..."
}
}
}
2) 受保护接口如何带 Token
后端把 session_key 当做 Token 使用，调用受保护接口时在 Header 中带：
Authorization: Bearer <session_key>
请求示例：
curl -X GET 'http://127.0.0.1:8080/api/v1/smoke/logs?page=1&page_size=20' \
-H 'Authorization: Bearer wx-session-key'