📡 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
💡 登入後可在 個人中心 獲取您的 API Key
📧

郵件 API（臨時郵箱）

適用於 Vinted、Gmail 等需要郵箱驗證的服務

GET /api/mail/getActivation.php

獲取一個臨時郵箱地址

參數

參數 必填 說明
api_key 是 您的 API Key
service 是 服務代碼（如 kc = Vinted）
domain 是 郵箱網域（如 gmail.com）
maxPrice 否 最高接受價格（如 0.05）

回應

{
  "status": 1,
  "mail": "xxx@gmail.com",
  "mailId": 12345678
}
GET /api/mail/getCode.php

獲取臨時郵箱收到的驗證碼

參數

參數 必填 說明
api_key 是 您的 API Key
mailId 是 郵箱 ID（getActivation 回傳）

回應

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

修改郵箱激活狀態（取消/完成）

狀態碼

狀態碼 說明
2 取消激活（不再需要此郵箱）
3 完成（成功收到驗證碼）
5 等待下一封郵件（重發）

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

# 1) 获取 Gmail 临时邮箱（service=kc 即 Vinted，可换 tg/wa/fb/gg 等） curl "https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&service=kc&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=等待下一封） 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