skills/cn86-sms-keyword-verification/references/lubansms-and-qwen-notes.md

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

成功示例：

{"code":0,"msg":"","balance":"96.72"}

2. 请求号码

GET /getKeywordNumber?apikey=YOUR_APIKEY&phone=&cardType=全部

成功示例：

{"code":0,"msg":"","phone":"18888888888"}

说明：

• phone 留空表示随机号码
• cardType 在官方文档里标成“已弃用”，但仍可兼容传 全部

3. 获取关键词短信

GET /getKeywordSms?apikey=YOUR_APIKEY&phone=<手机号>&keyword=<关键词>

等待中：

{"code":400,"msg":"尚未收到短信,请稍后重试"}

收到短信：

{"code":0,"msg":"【百度】验证码xxxx,您正在进行登陆验证."}

4. 释放号码

GET /delKeywordNumber?apikey=YOUR_APIKEY&phone=<手机号>

成功示例：

{"code":0,"msg":""}

5. 查询关键词短信历史

GET /keywordSmsHistory?apikey=YOUR_APIKEY&page=1

用途：

• 验证关键词是否正确
• 排查目标站点是否实际发过短信
• 辅助确认短信模板和验证码格式

千问专用备注

内部参考文档给出的要点：

• 千问示例关键词：千问
• 站点如果把国家码和手机号拆开，使用 phoneCode=86 + 原始手机号
• 接码平台 API 内部仍然按原始手机号查询，不要拼上 +86

2026-03-06 验证结论

已验证：

• getBalance 可正常返回余额
• keywordSmsHistory 可正常返回最近的千问短信历史
• 说明本技能里的示例流程和关键词方向是成立的

未在仓库中提交：

• 实际 API key
• 实际号码或敏感历史记录