📡 Документация API

Полное описание GreenSMS API: SMS и почтовая верификация

Авторизация

Все запросы должны содержать api_key в параметрах URL

GET https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&service=kc&domain=gmail.com&provider=smsbower
После входа API Key можно получить в Профиль
📧

Mail 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. Доступны только продукты с настроенной ценой. Канал G5 не поддерживает отмену и возврат.

Ответ

{
  "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"
📱

SMS API (верификация номера)

Для сервисов с верификацией номера: Telegram, WhatsApp

GET /stubs/handler_api.php?action=getNumber

Получить номер для приёма SMS-кодов

Параметр

Параметр Описание
service Код сервиса (напр. tg = Telegram, kc = Vinted)
country Код страны (напр. 0 = Россия, 6 = Индонезия)
GET /stubs/handler_api.php?action=getStatus

Получить статус SMS-кода

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