mirror of
https://github.com/bohd4nx/FragmentAPI.git
synced 2026-07-25 14:24:31 +00:00
bohd4nx
760c853acd
- Implemented Fragment API with methods for TON topups, Premium gifts, and Stars purchases. - Created configuration management using environment variables. - Added detailed README documentation for installation, configuration, and usage. - Developed utility classes for API client, wallet linking, and transaction processing. - Included example usage in main.py for easy demonstration of API functionalities. - Updated requirements.txt with necessary dependencies.
181 lines
12 KiB
Markdown
181 lines
12 KiB
Markdown
<div align="center">
|
||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 512 512" width="120" height="120" style="border-radius: 24px;"><defs><clipPath id="__lottie_element_2"><rect width="512" height="512" x="0" y="0"></rect></clipPath><clipPath id="__lottie_element_4"><path d="M0,0 L100,0 L100,100 L0,100z"></path></clipPath></defs><g clip-path="url(#__lottie_element_2)"><g clip-path="url(#__lottie_element_4)" style="display: block;" transform="matrix(5.119999885559082,0,0,5.119999885559082,0,0)" opacity="1"><g style="display: block;" transform="matrix(1.333299994468689,0,0,1.333299994468689,0,0)" opacity="1"><g opacity="1" transform="matrix(1,0,0,1,0,0)"><g opacity="1" transform="matrix(1,0,0,1,0,0)"><path fill="rgb(30,40,51)" fill-opacity="1" d=" M47.31999969482422,5.619999885559082 C47.31999969482422,5.619999885559082 27.68000030517578,5.619999885559082 27.68000030517578,5.619999885559082 C15.5,5.619999885559082 5.619999885559082,15.5 5.619999885559082,27.68000030517578 C5.619999885559082,27.68000030517578 5.619999885559082,47.31999969482422 5.619999885559082,47.31999969482422 C5.619999885559082,59.5 15.5,69.37999725341797 27.68000030517578,69.37999725341797 C27.68000030517578,69.37999725341797 47.31999969482422,69.37999725341797 47.31999969482422,69.37999725341797 C59.5,69.37999725341797 69.37999725341797,59.5 69.37999725341797,47.31999969482422 C69.37999725341797,47.31999969482422 69.37999725341797,27.68000030517578 69.37999725341797,27.68000030517578 C69.37999725341797,15.5 59.5,5.619999885559082 47.31999969482422,5.619999885559082 C47.31999969482422,5.619999885559082 47.31999969482422,5.619999885559082 47.31999969482422,5.619999885559082z"></path></g><g opacity="1" transform="matrix(1,0,0,1,0,0)"><path fill="rgb(255,255,255)" fill-opacity="1" d=" M36.349998474121094,32.79999923706055 C36.349998474121094,32.79999923706055 21.1299991607666,25.940000534057617 21.1299991607666,25.940000534057617 C20.020000457763672,25.450000762939453 20.389999389648438,23.790000915527344 21.600000381469727,23.790000915527344 C21.600000381469727,23.790000915527344 53.41999816894531,23.790000915527344 53.41999816894531,23.790000915527344 C54.630001068115234,23.790000915527344 54.9900016784668,25.440000534057617 53.880001068115234,25.940000534057617 C53.880001068115234,25.940000534057617 38.66999816894531,32.79999923706055 38.66999816894531,32.79999923706055 C37.939998626708984,33.130001068115234 37.09000015258789,33.130001068115234 36.36000061035156,32.79999923706055 C36.36000061035156,32.79999923706055 36.349998474121094,32.79999923706055 36.349998474121094,32.79999923706055z M56.81999969482422,30.06999969482422 C57.43000030517578,29.1200008392334 56.43000030517578,27.979999542236328 55.400001525878906,28.440000534057617 C55.400001525878906,28.440000534057617 40.72999954223633,35.13999938964844 40.72999954223633,35.13999938964844 C39.72999954223633,35.599998474121094 39.09000015258789,36.61000061035156 39.09000015258789,37.70000076293945 C39.09000015258789,37.70000076293945 39.09000015258789,53.810001373291016 39.09000015258789,53.810001373291016 C39.09000015258789,54.93000030517578 40.54999923706055,55.36000061035156 41.15999984741211,54.41999816894531 C41.15999984741211,54.41999816894531 56.810001373291016,30.06999969482422 56.810001373291016,30.06999969482422 C56.810001373291016,30.06999969482422 56.81999969482422,30.06999969482422 56.81999969482422,30.06999969482422z M19.600000381469727,28.440000534057617 C18.579999923706055,27.979999542236328 17.56999969482422,29.1200008392334 18.18000030517578,30.06999969482422 C18.18000030517578,30.06999969482422 33.84000015258789,54.43000030517578 33.84000015258789,54.43000030517578 C34.45000076293945,55.380001068115234 35.90999984741211,54.939998626708984 35.90999984741211,53.81999969482422 C35.90999984741211,53.81999969482422 35.90999984741211,37.70000076293945 35.90999984741211,37.70000076293945 C35.90999984741211,36.599998474121094 35.27000045776367,35.599998474121094 34.27000045776367,35.13999938964844 C34.27000045776367,35.13999938964844 19.59000015258789,28.450000762939453 19.59000015258789,28.450000762939453 C19.59000015258789,28.450000762939453 19.600000381469727,28.440000534057617 19.600000381469727,28.440000534057617z"></path></g></g></g></g></g></svg>
|
||
|
||
<h1 style="margin-top: 24px;">💎 Fragment API от @bohd4nx</h1>
|
||
|
||
<p style="font-size: 18px; margin-bottom: 24px;">
|
||
<b>Автоматизация пополнений TON, покупки Telegram Premium и Stars через Fragment.com</b>
|
||
</p>
|
||
|
||
[Сообщить об ошибке](https://github.com/bohd4nx/fragmentapi/issues) · [Запросить функцию](https://github.com/bohd4nx/fragmentapi/issues) · [**Донат TON**](https://app.tonkeeper.com/transfer/UQBUAa7KCx1ifmoEy6lF7j-822Dm_cE1j9SR7UWteu3jzukV)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## ✨ Возможности
|
||
|
||
- 💰 **Пополнение TON для рекламы** - Отправка TON для рекламных кампаний и покупки подарков (1-1,000,000,000 TON)
|
||
- 👑 **Подарки Telegram Premium** - Покупка Premium подписок(3, 6 или 12 месяцев)
|
||
- ⭐ **Покупка Telegram Stars** - Покупка Stars для пользователей (50-1,000,000 Stars)
|
||
|
||
## 🚀 Быстрый старт
|
||
|
||
### 1. Установка
|
||
|
||
```bash
|
||
git clone https://github.com/bohd4nx/FragmentAPI.git
|
||
cd FragmentAPI
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 2. Настройка
|
||
|
||
Скопируйте пример конфигурации и отредактируйте:
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
Отредактируйте файл `.env`:
|
||
|
||
```env
|
||
COOKIES = your_fragment_cookies_here
|
||
|
||
SEED = word1 word2 word3 ... word24
|
||
|
||
HASH = your_fragment_hash_here
|
||
|
||
API_KEY = your_ton_api_key_here
|
||
```
|
||
|
||
### 3. Получение необходимых данных
|
||
|
||
#### 🍪 Куки Fragment.com
|
||
|
||
**Предварительные требования**: Войдите в свой аккаунт Telegram и подключите TON кошелёк, который хотите использовать для платежей.
|
||
|
||
1. **Установите расширение Cookie Editor**:
|
||
|
||
- Скачайте из [Chrome Web Store](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm)
|
||
- Добавьте расширение в ваш браузер
|
||
|
||
2. **Извлечение куки**:
|
||
- Откройте [Fragment.com](https://fragment.com) и убедитесь, что вы вошли в систему
|
||
- Полностью обновите страницу
|
||
- Нажмите на иконку расширения Cookie Editor
|
||
- Нажмите кнопку **"Export"**
|
||
- Выберите формат **"Header String"**
|
||
- Скопируйте результат → вставьте в `COOKIES` в вашем `.env` файле
|
||
- **Важно**: Заключите значение в кавычки, чтобы точки с запятой не интерпретировались как комментарии
|
||
|
||
**Ожидаемый формат**:
|
||
|
||
```env
|
||
COOKIES = "stel_token=<TOKEN>;stel_dt=<STEL_DT>;stel_ssid=<SSID>;stel_ton_token=<TON_TOKEN>"
|
||
```
|
||
|
||
#### 🔐 Seed-фраза TON кошелька
|
||
|
||
**Если у вас ещё нет TON кошелька**:
|
||
|
||
1. **Скачайте Tonkeeper**:
|
||
|
||
- iOS: [App Store](https://apps.apple.com/app/tonkeeper/id1587742107)
|
||
- Android: [Google Play](https://play.google.com/store/apps/details?id=com.ton_keeper)
|
||
|
||
2. **Создайте новый кошелёк**:
|
||
|
||
- Откройте приложение Tonkeeper
|
||
- Нажмите **"Создать новый кошелёк"**
|
||
- **ВАЖНО**: Запишите вашу 24-словную seed-фразу на бумаге
|
||
- Храните её в безопасном месте - никогда не делитесь ей ни с кем!
|
||
- Завершите настройку кошелька
|
||
|
||
3. **Получите вашу seed-фразу**:
|
||
- Если у вас уже есть кошелёк, перейдите в Настройки → Резервное копирование
|
||
- Введите ваш пароль
|
||
- Скопируйте 24 слова → вставьте в `SEED` в вашем `.env` файле
|
||
|
||
**Формат**: `слово1 слово2 слово3 ... слово24`
|
||
|
||
#### 🔗 Хеш Fragment
|
||
|
||
**Предварительные требования**: Сначала завершите настройку куки выше.
|
||
|
||
1. **Подключите кошелёк к Fragment**:
|
||
|
||
- Перейдите на [Fragment.com](https://fragment.com)
|
||
- Убедитесь, что ваш TON кошелёк подключён
|
||
- Войдите с вашим аккаунтом Telegram
|
||
|
||
2. **Извлечение хеша**:
|
||
- Откройте **Инструменты разработчика** (F12)
|
||
- Нажмите на вкладку **"Сеть"**
|
||
- Перейдите к [покупке Stars](https://fragment.com/stars/buy)
|
||
- Выберите получателя как **"Buy for myself"**
|
||
- Обновите страницу (Ctrl+R / Cmd+R)
|
||
- Найдите сетевые запросы, содержащие `?hash=`
|
||
- Найдите значение хеша и скопируйте его → вставьте в `HASH` в вашем `.env` файле
|
||
|
||
**Ожидаемый формат**: `?hash=<ваш_хеш_здесь>`
|
||
|
||
#### 🔑 API ключ TON
|
||
|
||
1. **Получите API ключ**:
|
||
- Посетите [TON Console](https://tonconsole.com)
|
||
- Создайте аккаунт и войдите
|
||
- Сгенерируйте новый API ключ
|
||
- Скопируйте ключ → вставьте в `API_KEY` в вашем `.env` файле
|
||
|
||
**Альтернатива**: Вы также можете использовать [TON API](https://tonapi.io) для получения API ключа.
|
||
|
||
### 4. Использование
|
||
|
||
#### Запуск примеров
|
||
|
||
```bash
|
||
python main.py
|
||
```
|
||
|
||
#### Программное использование
|
||
|
||
```python
|
||
from app.methods import FragmentTon, FragmentPremium, FragmentStars
|
||
|
||
# Пополнение TON для рекламы
|
||
ton_client = FragmentTon()
|
||
result = await ton_client.topup_ton("@username", 5)
|
||
|
||
# Покупка Premium
|
||
premium_client = FragmentPremium()
|
||
result = await premium_client.buy_premium("@username", 6)
|
||
|
||
# Покупка Stars
|
||
stars_client = FragmentStars()
|
||
result = await stars_client.buy_stars("@username", 50)
|
||
```
|
||
|
||
### Поддерживаемые операции
|
||
|
||
| Операция | Метод | Параметры | Ограничения |
|
||
| ------------------- | ------------------------------- | ---------------------------------- | ------------------- |
|
||
| **Пополнение TON** | `topup_ton(username, amount)` | Имя пользователя, количество TON | 1-1,000,000,000 TON |
|
||
| **Подарок Premium** | `buy_premium(username, months)` | Имя пользователя, длительность | 3, 6 или 12 месяцев |
|
||
| **Покупка Stars** | `buy_stars(username, amount)` | Имя пользователя, количество Stars | 50-1,000,000 Stars |
|
||
|
||
### Форматы имён пользователей
|
||
|
||
Все методы принимают различные форматы имён пользователей:
|
||
|
||
- `@username` (с @)
|
||
- `username` (без @)
|
||
|
||
<div align="center">
|
||
|
||
### Made with ❤️ by [@bohd4nx](https://t.me/bohd4nx)
|
||
|
||
**Поставьте ⭐ этому репозиторию, если он оказался полезным!**
|
||
|
||
</div>
|