📡 API 文档

GreenSMS API 完整接口说明，支持短信和邮件两种验证方式

🔑 认证方式

所有 API 请求需要在 URL 参数中携带您的 api_key

GET https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&service=kc&domain=gmail.com&provider=smsbower
💡 登录后可在 个人中心 获取您的 API Key
📧

邮件 API（临时邮箱）

适用于 Vinted、Gmail 等需要邮箱验证的服务

GET /api/mail/getActivation.php

获取一个临时邮箱地址

参数

参数 必填 说明
api_key 是 您的 API Key
service 是 服务代码（如 kc = Vinted）
provider 否 邮箱渠道：留空 / smsbower = BO邮箱（service 用服务码，如 kc）；gmail500 = G5邮箱（service 用产品编号，如 6074 = Vinted）
domain 是 邮箱域名（如 gmail.com）
maxPrice 否 最高接受价格（如 0.05）

G5邮箱（provider=gmail500）常用产品编号：Vinted=6074 / TikTok=1001 / Instagram=1002 / Apple=1003 / PayPal=1004 / Facebook=1005 / X=1006 / Amazon=1007 / LinkedIn=1009 / Telegram=1011 / Airbnb=1021。仅后台已配置价格的产品可用；该渠道不支持取消退费。

响应

{
  "status": 1,
  "mail": "xxx@gmail.com",
  "mailId": "12345678",
  "provider": "smsbower",
  "cancellable": true,
  "expires_at": 1790000000
}
GET /api/mail/getCode.php

获取临时邮箱收到的验证码

参数

参数 必填 说明
api_key 是 您的 API Key
mailId 是 邮箱 ID（getActivation 返回）

响应

{
  "status": 1,
  "code": "123456"
}
GET /api/mail/setStatus.php

修改邮箱激活状态（取消/完成）

状态码

状态码 说明
2 取消激活（不再需要此邮箱）
3 完成（成功收到验证码）
5 等待下一个邮件（重发）

G5邮箱（provider=gmail500）不支持取消退费：调用 status=2 会返回 {"status":0,"no_refund":true}，邮箱到期后自动失效（不退款）。BO邮箱（smsbower）仍支持取消退费。

🚀 Gmail 接码完整示例 / Gmail receiving example

# 1) 获取 Gmail 临时邮箱 # BO邮箱（默认渠道，service 用服务码，如 kc=Vinted） curl "https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&service=kc&domain=gmail.com" # G5邮箱（provider=gmail500，service 用产品编号，如 6074=Vinted / 1001=TikTok） curl "https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&provider=gmail500&service=6074&domain=gmail.com" # 2) 轮询获取验证码（用第1步返回的 mailId 替换 MAILID） curl "https://www.greensms.net/api/mail/getCode.php?api_key=YOUR_API_KEY&mail_id=MAILID" # 3) 释放邮箱（status: 2=取消退费 3=完成 5=等待下一封） # 注意：G5邮箱（provider=gmail500）不支持取消退费，status=2 会返回 no_refund curl "https://www.greensms.net/api/mail/setStatus.php?api_key=YOUR_API_KEY&mail_id=MAILID&status=2"
📱

短信 API（手机号验证）

适用于 Telegram、WhatsApp 等需要手机号验证的服务

GET /stubs/handler_api.php?action=getNumber

获取一个手机号用于接收短信验证码

参数

参数 说明
service 服务代码（如 tg = Telegram, kc = Vinted）
country 国家代码（如 0 = 俄罗斯, 6 = 印度尼西亚）
GET /stubs/handler_api.php?action=getStatus

获取短信验证码状态

STATUS_OK:123456
STATUS_WAIT_CODE
STATUS_CANCEL

📋 常用服务代码

🛍️
Vinted
kc
✈️
Telegram
tg
💬
WhatsApp
wa
📘
Facebook
fb
🔍
Google
gg
📞
Viber
vi
📷
Instagram
ig
🐦
Twitter
tw
📧
Email
em
📦
Amazon
am