sms4u.vip API 文档

使用 sms4u.vip API 获取虚拟号码、查询价格、管理订单。所有接口需要 API Key 鉴权。

认证方式

在请求头中加入 Authorization: APPCODE your-api-key。

API Key 请在 sms4u.vip 个人中心 获取（登录后访问 "我的API"）。

基础 URL

https://www.sms4u.vip

接口列表

1. 获取国家列表

GET /api/bus/v1/arealist

返回所有可用国家及其代码。

curl "https://www.sms4u.vip/api/bus/v1/arealist" \
  -H "Authorization: APPCODE your-api-key"

2. 获取服务列表

GET /api/bus/v1/siteapplist
curl "https://www.sms4u.vip/api/bus/v1/siteapplist" \
  -H "Authorization: APPCODE your-api-key"

3. 按国家查询价格

GET /api/bus/v1/pricelistbyarea
参数类型必填说明
AreaCodestring是国家代码，如 usa、singapore
curl "https://www.sms4u.vip/api/bus/v1/pricelistbyarea?AreaCode=usa" \
  -H "Authorization: APPCODE your-api-key"

4. 按服务查询价格

GET /api/bus/v1/pricelistbysiteapp
参数类型必填说明
SiteappCodestring是服务代码，如 telegram、whatsapp

5. 按国家+服务查运营商价格

GET /api/bus/v1/pricelistbyareasiteapp
参数类型必填说明
AreaCodestring是国家代码
SiteappCodestring是服务代码

6. 查询余额

GET /api/bus/v1/querybalance

7. 购买号码

GET /api/bus/v1/buynumber
参数类型必填说明
AreaCodestring是国家代码
SiteappCodestring是服务代码
OperatorCodestring是运营商代码，填 any 为任意

限流规则：每 Key 每日最多 50 单、两次下单间隔至少 3 秒、同时进行中订单不超过 10 个。

curl "https://www.sms4u.vip/api/bus/v1/buynumber?AreaCode=usa&SiteappCode=telegram&OperatorCode=any" \
  -H "Authorization: APPCODE your-api-key"

8. 查询订单 / 获取短信

GET /api/bus/v1/queryorder
参数类型必填说明
Snstring是订单号（购买时返回的 sn）

9. 完成订单

GET /api/bus/v1/finishorder
参数类型必填说明
Snstring是订单号

注意：只有收到短信后（status 为 RECEIVED）才能完成订单。

10. 取消订单

GET /api/bus/v1/cancelorder
参数类型必填说明
Snstring是订单号

注意：只有未收到短信的订单才能取消。

11. 复用号码

GET /api/bus/v1/rebuyNumber
参数类型必填说明
Snstring是原订单号

订单状态说明

状态说明
WAITING等待短信
RECEIVED已收到短信
FINISHED已完成
CANCELED已取消
TIMEOUT已过期

错误码

code说明
0成功
1失败（详见 message）

sms4u.vip © 2022-2026