# 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
- 实际号码或敏感历史记录