📡 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