97 行
2.1 KiB
Markdown
97 行
2.1 KiB
Markdown
# LubanSMS / Qwen Notes
|
||
|
||
## 来源
|
||
|
||
这份参考整理自两部分：
|
||
|
||
1. 官方 API 文档：`https://lubansms.com/api_docs/`
|
||
2. 内部参考：`hao/one` 仓库里的 `docs/sms-register-qwen.md`
|
||
|
||
## 关键结论
|
||
|
||
- 这次要做的“86 手机号 + 关键词获取验证码”流程，落地接口是 LubanSMS 的 **通用短信接收** 系列。
|
||
- 内部参考文档把千问（Qwen）作为示例站点，关键词给的是 `千问`。
|
||
- 运行时应该使用环境变量 `LUBAN_SMS_APIKEY`，而不是把真实 key 提交到仓库。
|
||
|
||
## 官方接口
|
||
|
||
### 1. 查询余额
|
||
|
||
`GET /getBalance?apikey=YOUR_APIKEY`
|
||
|
||
成功示例：
|
||
|
||
```json
|
||
{"code":0,"msg":"","balance":"96.72"}
|
||
```
|
||
|
||
### 2. 请求号码
|
||
|
||
`GET /getKeywordNumber?apikey=YOUR_APIKEY&phone=&cardType=全部`
|
||
|
||
成功示例：
|
||
|
||
```json
|
||
{"code":0,"msg":"","phone":"18888888888"}
|
||
```
|
||
|
||
说明：
|
||
- `phone` 留空表示随机号码
|
||
- `cardType` 在官方文档里标成“已弃用”，但仍可兼容传 `全部`
|
||
|
||
### 3. 获取关键词短信
|
||
|
||
`GET /getKeywordSms?apikey=YOUR_APIKEY&phone=<手机号>&keyword=<关键词>`
|
||
|
||
等待中：
|
||
|
||
```json
|
||
{"code":400,"msg":"尚未收到短信,请稍后重试"}
|
||
```
|
||
|
||
收到短信：
|
||
|
||
```json
|
||
{"code":0,"msg":"【百度】验证码xxxx,您正在进行登陆验证."}
|
||
```
|
||
|
||
### 4. 释放号码
|
||
|
||
`GET /delKeywordNumber?apikey=YOUR_APIKEY&phone=<手机号>`
|
||
|
||
成功示例：
|
||
|
||
```json
|
||
{"code":0,"msg":""}
|
||
```
|
||
|
||
### 5. 查询关键词短信历史
|
||
|
||
`GET /keywordSmsHistory?apikey=YOUR_APIKEY&page=1`
|
||
|
||
用途：
|
||
- 验证关键词是否正确
|
||
- 排查目标站点是否实际发过短信
|
||
- 辅助确认短信模板和验证码格式
|
||
|
||
## 千问专用备注
|
||
|
||
内部参考文档给出的要点：
|
||
|
||
- 千问示例关键词：`千问`
|
||
- 站点如果把国家码和手机号拆开，使用 `phoneCode=86` + 原始手机号
|
||
- 接码平台 API 内部仍然按原始手机号查询，不要拼上 `+86`
|
||
|
||
## 2026-03-06 验证结论
|
||
|
||
已验证：
|
||
|
||
- `getBalance` 可正常返回余额
|
||
- `keywordSmsHistory` 可正常返回最近的千问短信历史
|
||
- 说明本技能里的示例流程和关键词方向是成立的
|
||
|
||
未在仓库中提交：
|
||
|
||
- 实际 API key
|
||
- 实际号码或敏感历史记录
|