dreamSMS

Обзор

dreamSMS — это революционный сервис для получения кодов активации прямо в Telegram. Забудьте о медленных SMS и получайте коды мгновенно в удобном интерфейсе.

Быстрый старт

API Endpoints

Отправка кода активации

Описание: Отправляет код активации пользователю в Telegram.

Параметры запроса (JSON):

Пример запроса:

POST https://sms.dreampartners.online/api/sms/send
Content-Type: application/json

{
    "api_key": "ваш_апи_ключ_здесь",
    "phone": "+79991234567",
    "code": "123456"
}

Пример успешного ответа:

{
    "success": true,
    "message": "Code sent successfully"
}

Проверка кода и получение данных пользователя

Описание: Проверяет правильность кода. Если передан api_key, возвращает данные пользователя для регистрации в вашем сервисе.

Параметры запроса (JSON):

Пример с получением данных пользователя:

POST https://sms.dreampartners.online/api/sms/verify
Content-Type: application/json

{
    "phone": "+79991234567",
    "code": "123456",
    "api_key": "ваш_апи_ключ"
}

Ответ:
{
    "success": true,
    "message": "Code verified successfully",
    "user_data": {
        "user_id": 123456789,
        "phone": "+79991234567",
        "username": "ivan_ivanov",
        "first_name": "Иван",
        "telegram_username": "ivan_ivanov"
    }
}

Получение аватара и данных пользователя

Описание: Получает аватар пользователя из Telegram по номеру телефона. Также возвращает Telegram username пользователя.

Параметры запроса (JSON):

Пример запроса:

POST https://sms.dreampartners.online/api/sms/get-avatar
Content-Type: application/json
X-API-Key: ваш_апи_ключ

{
    "phone": "+79991234567"
}

Пример успешного ответа:

{
    "success": true,
    "avatar_url": "https://api.telegram.org/file/bot.../avatar.jpg",
    "username": "ivan_ivanov"
}

💡 Примечание: Если аватар уже сохранен в базе данных, он возвращается сразу. Если нет, система автоматически получает его из Telegram API и сохраняет для последующих запросов. Поле username всегда возвращается, если пользователь зарегистрирован в боте.

Проверка статуса API

Описание: Проверяет доступность API.

Пример ответа:

{
    "success": true,
    "service": "dreamSMS",
    "status": "online",
    "version": "2.0"
}

Демо режим (без API ключа)

Описание: Отправляет тестовый код без необходимости API ключа. Идеально для проверки работы сервиса.

Параметры запроса (JSON):

Пример запроса:

POST https://sms.dreampartners.online/api/sms/demo/send
Content-Type: application/json

{
    "phone": "+79991234567"
}

Примеры кода

Python - Регистрация через Telegram

import requests
import random

API_KEY = "ваш_апи_ключ"
BASE_URL = "https://sms.dreampartners.online/api/sms"

def register_user_via_telegram(phone):
    # 1. Генерируем и отправляем код
    code = str(random.randint(100000, 999999))
    
    send_response = requests.post(f"{BASE_URL}/send", json={
        "api_key": API_KEY,
        "phone": phone,
        "code": code
    })
    
    if not send_response.json()["success"]:
        return {"error": "Не удалось отправить код"}
    
    # 2. Пользователь получает код в Telegram и вводит на сайте
    user_code = input("Введите код из Telegram: ")
    
    # 3. Проверяем код и получаем данные пользователя
    verify_response = requests.post(f"{BASE_URL}/verify", json={
        "phone": phone,
        "code": user_code,
        "api_key": API_KEY  # Получаем данные пользователя!
    })
    
    result = verify_response.json()
    
    if result["success"] and "user_data" in result:
        user = result["user_data"]
        print(f"Пользователь: {user['first_name']}")
        print(f"Telegram: @{user['username']}")
        print(f"Telegram username: {user.get('telegram_username', user['username'])}")
        
        # Регистрируем в своей БД
        # create_user_in_database(user)
        
        return user
    else:
        return {"error": "Неверный код"}

# Использование
user = register_user_via_telegram("+79991234567")

JavaScript (Node.js)

const axios = require('axios');

const API_KEY = 'ваш_апи_ключ';
const BASE_URL = 'https://sms.dreampartners.online/api/sms';

async function sendActivationCode(phone, code) {
    const url = `${BASE_URL}/send`;
    const payload = {
        api_key: API_KEY,
        phone: phone,
        code: code
    };
    
    try {
        const response = await axios.post(url, payload);
        return response.data;
    } catch (error) {
        console.error('Error:', error.response.data);
    }
}

async function getUserAvatar(phone) {
    const url = `${BASE_URL}/get-avatar`;
    const payload = { phone: phone };
    
    try {
        const response = await axios.post(url, payload, {
            headers: { 'X-API-Key': API_KEY }
        });
        return response.data;
    } catch (error) {
        console.error('Error:', error.response.data);
    }
}

// Использование
sendActivationCode('+79991234567', '123456')
    .then(result => console.log(result));

// Получение аватара и username
getUserAvatar('+79991234567')
    .then(data => {
        if (data.success) {
            console.log('Avatar:', data.avatar_url);
            console.log('Username:', data.username);
        }
    });

PHP

<?php
function sendActivationCode($phone, $code) {
    $url = 'https://sms.dreampartners.online/api/sms/send';
    $data = array(
        'api_key' => 'ваш_апи_ключ',
        'phone' => $phone,
        'code' => $code
    );
    
    $options = array(
        'http' => array(
            'header'  => "Content-type: application/json\r\n",
            'method'  => 'POST',
            'content' => json_encode($data)
        )
    );
    
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    
    return json_decode($result, true);
}

// Использование
$result = sendActivationCode('+79991234567', '123456');
print_r($result);
?>

Тестирование API

Часто задаваемые вопросы