| Name | reghelp-client JSON |
| Version |
1.1.5
JSON |
| download |
| home_page | None |
| Summary | Современная асинхронная Python библиотека для работы с REGHelp Key API |
| upload_time | 2025-07-14 03:14:25 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT License Copyright (c) 2025 REGHelp Team Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
reghelp
api
client
async
push
email
telegram
integrity
recaptcha
turnstile
voip
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
httpx
pydantic
typing-extensions
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# REGHelp Python Client / REGHelp Python Client (Русская версия ниже)
## 🇬🇧 English
Modern asynchronous Python library for interacting with the REGHelp Key API. It supports all services: Push tokens, Email, Integrity, Turnstile, VoIP Push and Recaptcha Mobile.
### 🚀 Features
* **Asynchronous first** – full `async`/`await` support powered by `httpx`.
* **Type-safe** – strict typing with Pydantic data models.
* **Retries with exponential back-off** built-in.
* **Smart rate-limit handling** (50 requests per second).
* **Async context-manager** for automatic resource management.
* **Webhook support** out of the box.
* **Comprehensive error handling** with dedicated exception classes.
### 📦 Installation
```bash
pip install reghelp-client
```
For development:
```bash
pip install "reghelp-client[dev]"
```
### 🔧 Quick start
```python
import asyncio
from reghelp_client import RegHelpClient, AppDevice, EmailType
async def main():
async with RegHelpClient("your_api_key") as client:
# Check balance
balance = await client.get_balance()
print(f"Balance: {balance.balance} {balance.currency}")
# Get Telegram iOS push token
task = await client.get_push_token(
app_name="tgiOS",
app_device=AppDevice.IOS
)
print(f"Push token: {task.token}")
# Wait for result
result = await client.wait_for_result(task.id, "push")
print(f"Push token: {result.token}")
if __name__ == "__main__":
asyncio.run(main())
```
---
# RU Русская версия
Современная асинхронная Python библиотека для работы с REGHelp Key API. Поддерживает все сервисы: Push tokens, Email, Integrity, Turnstile, VoIP Push, Recaptcha Mobile.
## 🚀 Возможности
- **Асинхронность**: Полная поддержка async/await
- **Типизация**: Полная типизация с Pydantic моделями
- **Retry логика**: Автоматические повторы с exponential backoff
- **Rate limiting**: Умная обработка rate limits (50 rps)
- **Context manager**: Поддержка async context manager
- **Webhook support**: Поддержка webhook уведомлений
- **Comprehensive error handling**: Детальная обработка всех ошибок API
## 📦 Установка
```bash
pip install reghelp-client
```
Или для разработки:
```bash
pip install reghelp-client[dev]
```
## 🔧 Быстрый старт
```python
import asyncio
from reghelp_client import RegHelpClient, AppDevice, EmailType
async def main():
async with RegHelpClient("your_api_key") as client:
# Проверить баланс
balance = await client.get_balance()
print(f"Баланс: {balance.balance} {balance.currency}")
# Получить push токен для Telegram iOS
task = await client.get_push_token(
app_name="tgiOS",
app_device=AppDevice.IOS
)
print(f"Задача создана: {task.id}")
# Ждать результат
result = await client.wait_for_result(task.id, "push")
print(f"Push токен: {result.token}")
if __name__ == "__main__":
asyncio.run(main())
```
## 📚 Документация API
### Инициализация клиента
```python
from reghelp_client import RegHelpClient
# Базовое использование
client = RegHelpClient("your_api_key")
# С кастомными настройками
client = RegHelpClient(
api_key="your_api_key",
base_url="https://api.reghelp.net",
timeout=30.0,
max_retries=3,
retry_delay=1.0
)
# Использование как context manager (рекомендуется)
async with RegHelpClient("your_api_key") as client:
# Ваш код здесь
pass
```
### 📱 Push Tokens
#### Получение push токена
```python
from reghelp_client import AppDevice
# Для Telegram iOS
task = await client.get_push_token(
app_name="tgiOS",
app_device=AppDevice.IOS,
app_version="10.9.2",
app_build="25345",
ref="my_ref_tag"
)
# Для Telegram Android
task = await client.get_push_token(
app_name="tg",
app_device=AppDevice.ANDROID
)
# Проверить статус
status = await client.get_push_status(task.id)
if status.status == "done":
print(f"Токен: {status.token}")
```
#### Поддерживаемые приложения
| Platform | app_name | Bundle ID |
|----------|----------|-----------|
| Android | `tg` | `org.telegram.messenger` |
| Android | `tg_beta` | `org.telegram.messenger.beta` |
| Android | `tg_web` | `org.telegram.messenger.web` |
| Android | `tg_x` | `org.thunderdog.challegram` |
| iOS | `tgiOS` | `ph.telegra.Telegraph` |
#### Отметка неуспешного токена
```python
from reghelp_client import PushStatusType
# Если токен оказался неработающим
await client.set_push_status(
task_id="task_id",
phone_number="+15551234567",
status=PushStatusType.NOSMS
)
```
### 📧 Email Service
```python
from reghelp_client import EmailType
# Получить временный email
email_task = await client.get_email(
app_name="tg",
app_device=AppDevice.IOS,
phone="+15551234567",
email_type=EmailType.ICLOUD
)
print(f"Email: {email_task.email}")
# Ждать код подтверждения
email_status = await client.wait_for_result(email_task.id, "email")
print(f"Код: {email_status.code}")
```
### 🔒 Integrity Service
```python
import base64
# Генерируем nonce
nonce = base64.urlsafe_b64encode(b"your_nonce_data").decode()
# Получить integrity токен
integrity_task = await client.get_integrity_token(
app_name="tg",
app_device=AppDevice.ANDROID,
nonce=nonce
)
# Ждать результат
result = await client.wait_for_result(integrity_task.id, "integrity")
print(f"Integrity токен: {result.token}")
```
### 🤖 Recaptcha Mobile
```python
from reghelp_client import ProxyConfig, ProxyType
# Настройка прокси
proxy = ProxyConfig(
type=ProxyType.HTTP,
address="proxy.example.com",
port=8080,
login="username", # опционально
password="password" # опционально
)
# Решить recaptcha
recaptcha_task = await client.get_recaptcha_mobile_token(
app_name="org.telegram.messenger",
app_device=AppDevice.ANDROID,
app_key="6Lc-recaptcha-site-key",
app_action="login",
proxy=proxy
)
# Ждать результат
result = await client.wait_for_result(recaptcha_task.id, "recaptcha")
print(f"Recaptcha токен: {result.token}")
```
### 🔐 Turnstile
```python
# Решить Cloudflare Turnstile
turnstile_task = await client.get_turnstile_token(
url="https://example.com/page",
site_key="0x4AAAA...",
action="login",
proxy="http://proxy.example.com:8080" # опционально
)
# Ждать результат
result = await client.wait_for_result(turnstile_task.id, "turnstile")
print(f"Turnstile токен: {result.token}")
```
### 📞 VoIP Push
```python
# Получить VoIP push токен
voip_task = await client.get_voip_token(
app_name="tgiOS",
ref="voip_ref"
)
# Ждать результат
result = await client.wait_for_result(voip_task.id, "voip")
print(f"VoIP токен: {result.token}")
```
### 🔄 Автоматическое ожидание результата
```python
# Автоматически ждать выполнения задачи
result = await client.wait_for_result(
task_id="task_id",
service="push", # push, email, integrity, recaptcha, turnstile, voip
timeout=180.0, # максимальное время ожидания
poll_interval=2.0 # интервал между проверками
)
```
### 🪝 Webhook поддержка
```python
# Создать задачу с webhook
task = await client.get_push_token(
app_name="tgiOS",
app_device=AppDevice.IOS,
webhook="https://yourapp.com/webhook"
)
# Когда задача завершится, на указанный URL придет POST запрос
# с JSON данными аналогичными ответу get_status
```
## 🚨 Обработка ошибок
```python
from reghelp_client import (
RegHelpError,
RateLimitError,
UnauthorizedError,
TaskNotFoundError,
NetworkError
)
try:
task = await client.get_push_token("tgiOS", AppDevice.IOS)
except RateLimitError:
print("Превышен лимит запросов (50/сек)")
except UnauthorizedError:
print("Неверный API ключ")
except TaskNotFoundError as e:
print(f"Задача не найдена: {e.task_id}")
except NetworkError as e:
print(f"Сетевая ошибка: {e}")
except RegHelpError as e:
print(f"API ошибка: {e}")
```
## ⚙️ Конфигурация
### Логирование
```python
import logging
# Включить debug логи
logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger("reghelp_client")
```
### Кастомный HTTP клиент
```python
import httpx
# Использовать свой HTTP клиент
custom_client = httpx.AsyncClient(
timeout=60.0,
verify=False # отключить SSL проверку (не рекомендуется)
)
client = RegHelpClient(
api_key="your_api_key",
http_client=custom_client
)
```
## 🧪 Примеры для разных случаев
### Массовое получение токенов
```python
import asyncio
async def get_multiple_tokens():
async with RegHelpClient("your_api_key") as client:
# Создать несколько задач параллельно
tasks = await asyncio.gather(*[
client.get_push_token("tgiOS", AppDevice.IOS)
for _ in range(5)
])
# Ждать все результаты
results = await asyncio.gather(*[
client.wait_for_result(task.id, "push")
for task in tasks
])
for i, result in enumerate(results):
print(f"Токен {i+1}: {result.token}")
```
### Работа с балансом
```python
async def manage_balance():
async with RegHelpClient("your_api_key") as client:
balance = await client.get_balance()
if balance.balance < 10:
print("Низкий баланс! Пополните аккаунт")
return
print(f"Текущий баланс: {balance.balance} {balance.currency}")
```
### Обработка длительных операций
```python
async def long_running_task():
async with RegHelpClient("your_api_key") as client:
task = await client.get_push_token("tgiOS", AppDevice.IOS)
# Проверять статус с кастомным интервалом
while True:
status = await client.get_push_status(task.id)
if status.status == "done":
print(f"Готово! Токен: {status.token}")
break
elif status.status == "error":
print(f"Ошибка: {status.message}")
break
print(f"Статус: {status.status}")
await asyncio.sleep(5) # проверять каждые 5 секунд
```
## 📋 Требования
- Python 3.8+
- httpx >= 0.27.0
- pydantic >= 2.0.0
## 📄 Лицензия
MIT License. См. [LICENSE](LICENSE) для деталей.
## 🤝 Поддержка
- Документация: https://reghelp.net/api-docs
- Поддержка: support@reghelp.net
- Issues: https://github.com/REGHELPNET/reghelp_client/issues
Raw data
{
"_id": null,
"home_page": null,
"name": "reghelp-client",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "REGHelp Team <support@reghelp.net>",
"keywords": "reghelp, api, client, async, push, email, telegram, integrity, recaptcha, turnstile, voip",
"author": null,
"author_email": "REGHelp Team <support@reghelp.net>",
"download_url": "https://files.pythonhosted.org/packages/a5/ba/18667e0f4f416e2978b163c7b51f887f04fd31bb9bb6dfa4bbadd020370d/reghelp_client-1.1.5.tar.gz",
"platform": null,
"description": "# REGHelp Python Client / REGHelp Python Client (\u0420\u0443\u0441\u0441\u043a\u0430\u044f \u0432\u0435\u0440\u0441\u0438\u044f \u043d\u0438\u0436\u0435)\n\n\n\n\n\n## \ud83c\uddec\ud83c\udde7 English\n\nModern asynchronous Python library for interacting with the REGHelp Key API. It supports all services: Push tokens, Email, Integrity, Turnstile, VoIP Push and Recaptcha Mobile.\n\n### \ud83d\ude80 Features\n\n* **Asynchronous first** \u2013 full `async`/`await` support powered by `httpx`.\n* **Type-safe** \u2013 strict typing with Pydantic data models.\n* **Retries with exponential back-off** built-in.\n* **Smart rate-limit handling** (50 requests per second).\n* **Async context-manager** for automatic resource management.\n* **Webhook support** out of the box.\n* **Comprehensive error handling** with dedicated exception classes.\n\n### \ud83d\udce6 Installation\n\n```bash\npip install reghelp-client\n```\n\nFor development:\n\n```bash\npip install \"reghelp-client[dev]\"\n```\n\n### \ud83d\udd27 Quick start\n\n```python\nimport asyncio\nfrom reghelp_client import RegHelpClient, AppDevice, EmailType\n\nasync def main():\n async with RegHelpClient(\"your_api_key\") as client:\n # Check balance\n balance = await client.get_balance()\n print(f\"Balance: {balance.balance} {balance.currency}\")\n \n # Get Telegram iOS push token\n task = await client.get_push_token(\n app_name=\"tgiOS\",\n app_device=AppDevice.IOS\n )\n print(f\"Push token: {task.token}\")\n \n # Wait for result\n result = await client.wait_for_result(task.id, \"push\")\n print(f\"Push token: {result.token}\")\n\nif __name__ == \"__main__\":\n asyncio.run(main())\n```\n\n---\n\n# RU \u0420\u0443\u0441\u0441\u043a\u0430\u044f \u0432\u0435\u0440\u0441\u0438\u044f\n\n\u0421\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u0430\u044f \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u0430\u044f Python \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u0441 REGHelp Key API. \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442 \u0432\u0441\u0435 \u0441\u0435\u0440\u0432\u0438\u0441\u044b: Push tokens, Email, Integrity, Turnstile, VoIP Push, Recaptcha Mobile.\n\n## \ud83d\ude80 \u0412\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438\n\n- **\u0410\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u043e\u0441\u0442\u044c**: \u041f\u043e\u043b\u043d\u0430\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 async/await\n- **\u0422\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f**: \u041f\u043e\u043b\u043d\u0430\u044f \u0442\u0438\u043f\u0438\u0437\u0430\u0446\u0438\u044f \u0441 Pydantic \u043c\u043e\u0434\u0435\u043b\u044f\u043c\u0438\n- **Retry \u043b\u043e\u0433\u0438\u043a\u0430**: \u0410\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0435 \u043f\u043e\u0432\u0442\u043e\u0440\u044b \u0441 exponential backoff\n- **Rate limiting**: \u0423\u043c\u043d\u0430\u044f \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430 rate limits (50 rps)\n- **Context manager**: \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 async context manager\n- **Webhook support**: \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 webhook \u0443\u0432\u0435\u0434\u043e\u043c\u043b\u0435\u043d\u0438\u0439\n- **Comprehensive error handling**: \u0414\u0435\u0442\u0430\u043b\u044c\u043d\u0430\u044f \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430 \u0432\u0441\u0435\u0445 \u043e\u0448\u0438\u0431\u043e\u043a API\n\n## \ud83d\udce6 \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\n\n```bash\npip install reghelp-client\n```\n\n\u0418\u043b\u0438 \u0434\u043b\u044f \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438:\n\n```bash\npip install reghelp-client[dev]\n```\n\n## \ud83d\udd27 \u0411\u044b\u0441\u0442\u0440\u044b\u0439 \u0441\u0442\u0430\u0440\u0442\n\n```python\nimport asyncio\nfrom reghelp_client import RegHelpClient, AppDevice, EmailType\n\nasync def main():\n async with RegHelpClient(\"your_api_key\") as client:\n # \u041f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c \u0431\u0430\u043b\u0430\u043d\u0441\n balance = await client.get_balance()\n print(f\"\u0411\u0430\u043b\u0430\u043d\u0441: {balance.balance} {balance.currency}\")\n \n # \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c push \u0442\u043e\u043a\u0435\u043d \u0434\u043b\u044f Telegram iOS\n task = await client.get_push_token(\n app_name=\"tgiOS\",\n app_device=AppDevice.IOS\n )\n print(f\"\u0417\u0430\u0434\u0430\u0447\u0430 \u0441\u043e\u0437\u0434\u0430\u043d\u0430: {task.id}\")\n \n # \u0416\u0434\u0430\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\n result = await client.wait_for_result(task.id, \"push\")\n print(f\"Push \u0442\u043e\u043a\u0435\u043d: {result.token}\")\n\nif __name__ == \"__main__\":\n asyncio.run(main())\n```\n\n## \ud83d\udcda \u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f API\n\n### \u0418\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u043a\u043b\u0438\u0435\u043d\u0442\u0430\n\n```python\nfrom reghelp_client import RegHelpClient\n\n# \u0411\u0430\u0437\u043e\u0432\u043e\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\nclient = RegHelpClient(\"your_api_key\")\n\n# \u0421 \u043a\u0430\u0441\u0442\u043e\u043c\u043d\u044b\u043c\u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430\u043c\u0438\nclient = RegHelpClient(\n api_key=\"your_api_key\",\n base_url=\"https://api.reghelp.net\",\n timeout=30.0,\n max_retries=3,\n retry_delay=1.0\n)\n\n# \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u043a\u0430\u043a context manager (\u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0443\u0435\u0442\u0441\u044f)\nasync with RegHelpClient(\"your_api_key\") as client:\n # \u0412\u0430\u0448 \u043a\u043e\u0434 \u0437\u0434\u0435\u0441\u044c\n pass\n```\n\n### \ud83d\udcf1 Push Tokens\n\n#### \u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 push \u0442\u043e\u043a\u0435\u043d\u0430\n\n```python\nfrom reghelp_client import AppDevice\n\n# \u0414\u043b\u044f Telegram iOS\ntask = await client.get_push_token(\n app_name=\"tgiOS\",\n app_device=AppDevice.IOS,\n app_version=\"10.9.2\",\n app_build=\"25345\",\n ref=\"my_ref_tag\"\n)\n\n# \u0414\u043b\u044f Telegram Android\ntask = await client.get_push_token(\n app_name=\"tg\",\n app_device=AppDevice.ANDROID\n)\n\n# \u041f\u0440\u043e\u0432\u0435\u0440\u0438\u0442\u044c \u0441\u0442\u0430\u0442\u0443\u0441\nstatus = await client.get_push_status(task.id)\nif status.status == \"done\":\n print(f\"\u0422\u043e\u043a\u0435\u043d: {status.token}\")\n```\n\n#### \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u043c\u044b\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f\n\n| Platform | app_name | Bundle ID |\n|----------|----------|-----------|\n| Android | `tg` | `org.telegram.messenger` |\n| Android | `tg_beta` | `org.telegram.messenger.beta` |\n| Android | `tg_web` | `org.telegram.messenger.web` |\n| Android | `tg_x` | `org.thunderdog.challegram` |\n| iOS | `tgiOS` | `ph.telegra.Telegraph` |\n\n#### \u041e\u0442\u043c\u0435\u0442\u043a\u0430 \u043d\u0435\u0443\u0441\u043f\u0435\u0448\u043d\u043e\u0433\u043e \u0442\u043e\u043a\u0435\u043d\u0430\n\n```python\nfrom reghelp_client import PushStatusType\n\n# \u0415\u0441\u043b\u0438 \u0442\u043e\u043a\u0435\u043d \u043e\u043a\u0430\u0437\u0430\u043b\u0441\u044f \u043d\u0435\u0440\u0430\u0431\u043e\u0442\u0430\u044e\u0449\u0438\u043c\nawait client.set_push_status(\n task_id=\"task_id\",\n phone_number=\"+15551234567\",\n status=PushStatusType.NOSMS\n)\n```\n\n### \ud83d\udce7 Email Service\n\n```python\nfrom reghelp_client import EmailType\n\n# \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0439 email\nemail_task = await client.get_email(\n app_name=\"tg\",\n app_device=AppDevice.IOS,\n phone=\"+15551234567\",\n email_type=EmailType.ICLOUD\n)\n\nprint(f\"Email: {email_task.email}\")\n\n# \u0416\u0434\u0430\u0442\u044c \u043a\u043e\u0434 \u043f\u043e\u0434\u0442\u0432\u0435\u0440\u0436\u0434\u0435\u043d\u0438\u044f\nemail_status = await client.wait_for_result(email_task.id, \"email\")\nprint(f\"\u041a\u043e\u0434: {email_status.code}\")\n```\n\n### \ud83d\udd12 Integrity Service\n\n```python\nimport base64\n\n# \u0413\u0435\u043d\u0435\u0440\u0438\u0440\u0443\u0435\u043c nonce\nnonce = base64.urlsafe_b64encode(b\"your_nonce_data\").decode()\n\n# \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c integrity \u0442\u043e\u043a\u0435\u043d\nintegrity_task = await client.get_integrity_token(\n app_name=\"tg\",\n app_device=AppDevice.ANDROID,\n nonce=nonce\n)\n\n# \u0416\u0434\u0430\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\nresult = await client.wait_for_result(integrity_task.id, \"integrity\")\nprint(f\"Integrity \u0442\u043e\u043a\u0435\u043d: {result.token}\")\n```\n\n### \ud83e\udd16 Recaptcha Mobile\n\n```python\nfrom reghelp_client import ProxyConfig, ProxyType\n\n# \u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u043f\u0440\u043e\u043a\u0441\u0438\nproxy = ProxyConfig(\n type=ProxyType.HTTP,\n address=\"proxy.example.com\",\n port=8080,\n login=\"username\", # \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e\n password=\"password\" # \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e\n)\n\n# \u0420\u0435\u0448\u0438\u0442\u044c recaptcha\nrecaptcha_task = await client.get_recaptcha_mobile_token(\n app_name=\"org.telegram.messenger\",\n app_device=AppDevice.ANDROID,\n app_key=\"6Lc-recaptcha-site-key\",\n app_action=\"login\",\n proxy=proxy\n)\n\n# \u0416\u0434\u0430\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\nresult = await client.wait_for_result(recaptcha_task.id, \"recaptcha\")\nprint(f\"Recaptcha \u0442\u043e\u043a\u0435\u043d: {result.token}\")\n```\n\n### \ud83d\udd10 Turnstile\n\n```python\n# \u0420\u0435\u0448\u0438\u0442\u044c Cloudflare Turnstile\nturnstile_task = await client.get_turnstile_token(\n url=\"https://example.com/page\",\n site_key=\"0x4AAAA...\",\n action=\"login\",\n proxy=\"http://proxy.example.com:8080\" # \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e\n)\n\n# \u0416\u0434\u0430\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\nresult = await client.wait_for_result(turnstile_task.id, \"turnstile\")\nprint(f\"Turnstile \u0442\u043e\u043a\u0435\u043d: {result.token}\")\n```\n\n### \ud83d\udcde VoIP Push\n\n```python\n# \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c VoIP push \u0442\u043e\u043a\u0435\u043d\nvoip_task = await client.get_voip_token(\n app_name=\"tgiOS\",\n ref=\"voip_ref\"\n)\n\n# \u0416\u0434\u0430\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\nresult = await client.wait_for_result(voip_task.id, \"voip\")\nprint(f\"VoIP \u0442\u043e\u043a\u0435\u043d: {result.token}\")\n```\n\n### \ud83d\udd04 \u0410\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043e\u0436\u0438\u0434\u0430\u043d\u0438\u0435 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0430\n\n```python\n# \u0410\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0436\u0434\u0430\u0442\u044c \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u044f \u0437\u0430\u0434\u0430\u0447\u0438\nresult = await client.wait_for_result(\n task_id=\"task_id\",\n service=\"push\", # push, email, integrity, recaptcha, turnstile, voip\n timeout=180.0, # \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u043e\u0435 \u0432\u0440\u0435\u043c\u044f \u043e\u0436\u0438\u0434\u0430\u043d\u0438\u044f\n poll_interval=2.0 # \u0438\u043d\u0442\u0435\u0440\u0432\u0430\u043b \u043c\u0435\u0436\u0434\u0443 \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0430\u043c\u0438\n)\n```\n\n### \ud83e\ude9d Webhook \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430\n\n```python\n# \u0421\u043e\u0437\u0434\u0430\u0442\u044c \u0437\u0430\u0434\u0430\u0447\u0443 \u0441 webhook\ntask = await client.get_push_token(\n app_name=\"tgiOS\",\n app_device=AppDevice.IOS,\n webhook=\"https://yourapp.com/webhook\"\n)\n\n# \u041a\u043e\u0433\u0434\u0430 \u0437\u0430\u0434\u0430\u0447\u0430 \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u0442\u0441\u044f, \u043d\u0430 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u0439 URL \u043f\u0440\u0438\u0434\u0435\u0442 POST \u0437\u0430\u043f\u0440\u043e\u0441\n# \u0441 JSON \u0434\u0430\u043d\u043d\u044b\u043c\u0438 \u0430\u043d\u0430\u043b\u043e\u0433\u0438\u0447\u043d\u044b\u043c\u0438 \u043e\u0442\u0432\u0435\u0442\u0443 get_status\n```\n\n## \ud83d\udea8 \u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430 \u043e\u0448\u0438\u0431\u043e\u043a\n\n```python\nfrom reghelp_client import (\n RegHelpError,\n RateLimitError,\n UnauthorizedError,\n TaskNotFoundError,\n NetworkError\n)\n\ntry:\n task = await client.get_push_token(\"tgiOS\", AppDevice.IOS)\nexcept RateLimitError:\n print(\"\u041f\u0440\u0435\u0432\u044b\u0448\u0435\u043d \u043b\u0438\u043c\u0438\u0442 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 (50/\u0441\u0435\u043a)\")\nexcept UnauthorizedError:\n print(\"\u041d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 API \u043a\u043b\u044e\u0447\")\nexcept TaskNotFoundError as e:\n print(f\"\u0417\u0430\u0434\u0430\u0447\u0430 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u0430: {e.task_id}\")\nexcept NetworkError as e:\n print(f\"\u0421\u0435\u0442\u0435\u0432\u0430\u044f \u043e\u0448\u0438\u0431\u043a\u0430: {e}\")\nexcept RegHelpError as e:\n print(f\"API \u043e\u0448\u0438\u0431\u043a\u0430: {e}\")\n```\n\n## \u2699\ufe0f \u041a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f\n\n### \u041b\u043e\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435\n\n```python\nimport logging\n\n# \u0412\u043a\u043b\u044e\u0447\u0438\u0442\u044c debug \u043b\u043e\u0433\u0438\nlogging.basicConfig(level=logging.DEBUG)\nlogger = logging.getLogger(\"reghelp_client\")\n```\n\n### \u041a\u0430\u0441\u0442\u043e\u043c\u043d\u044b\u0439 HTTP \u043a\u043b\u0438\u0435\u043d\u0442\n\n```python\nimport httpx\n\n# \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0441\u0432\u043e\u0439 HTTP \u043a\u043b\u0438\u0435\u043d\u0442\ncustom_client = httpx.AsyncClient(\n timeout=60.0,\n verify=False # \u043e\u0442\u043a\u043b\u044e\u0447\u0438\u0442\u044c SSL \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 (\u043d\u0435 \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0443\u0435\u0442\u0441\u044f)\n)\n\nclient = RegHelpClient(\n api_key=\"your_api_key\",\n http_client=custom_client\n)\n```\n\n## \ud83e\uddea \u041f\u0440\u0438\u043c\u0435\u0440\u044b \u0434\u043b\u044f \u0440\u0430\u0437\u043d\u044b\u0445 \u0441\u043b\u0443\u0447\u0430\u0435\u0432\n\n### \u041c\u0430\u0441\u0441\u043e\u0432\u043e\u0435 \u043f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0442\u043e\u043a\u0435\u043d\u043e\u0432\n\n```python\nimport asyncio\n\nasync def get_multiple_tokens():\n async with RegHelpClient(\"your_api_key\") as client:\n # \u0421\u043e\u0437\u0434\u0430\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0437\u0430\u0434\u0430\u0447 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e\n tasks = await asyncio.gather(*[\n client.get_push_token(\"tgiOS\", AppDevice.IOS)\n for _ in range(5)\n ])\n \n # \u0416\u0434\u0430\u0442\u044c \u0432\u0441\u0435 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b\n results = await asyncio.gather(*[\n client.wait_for_result(task.id, \"push\")\n for task in tasks\n ])\n \n for i, result in enumerate(results):\n print(f\"\u0422\u043e\u043a\u0435\u043d {i+1}: {result.token}\")\n```\n\n### \u0420\u0430\u0431\u043e\u0442\u0430 \u0441 \u0431\u0430\u043b\u0430\u043d\u0441\u043e\u043c\n\n```python\nasync def manage_balance():\n async with RegHelpClient(\"your_api_key\") as client:\n balance = await client.get_balance()\n \n if balance.balance < 10:\n print(\"\u041d\u0438\u0437\u043a\u0438\u0439 \u0431\u0430\u043b\u0430\u043d\u0441! \u041f\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435 \u0430\u043a\u043a\u0430\u0443\u043d\u0442\")\n return\n \n print(f\"\u0422\u0435\u043a\u0443\u0449\u0438\u0439 \u0431\u0430\u043b\u0430\u043d\u0441: {balance.balance} {balance.currency}\")\n```\n\n### \u041e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0430 \u0434\u043b\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0445 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439\n\n```python\nasync def long_running_task():\n async with RegHelpClient(\"your_api_key\") as client:\n task = await client.get_push_token(\"tgiOS\", AppDevice.IOS)\n \n # \u041f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u0441\u0442\u0430\u0442\u0443\u0441 \u0441 \u043a\u0430\u0441\u0442\u043e\u043c\u043d\u044b\u043c \u0438\u043d\u0442\u0435\u0440\u0432\u0430\u043b\u043e\u043c\n while True:\n status = await client.get_push_status(task.id)\n \n if status.status == \"done\":\n print(f\"\u0413\u043e\u0442\u043e\u0432\u043e! \u0422\u043e\u043a\u0435\u043d: {status.token}\")\n break\n elif status.status == \"error\":\n print(f\"\u041e\u0448\u0438\u0431\u043a\u0430: {status.message}\")\n break\n \n print(f\"\u0421\u0442\u0430\u0442\u0443\u0441: {status.status}\")\n await asyncio.sleep(5) # \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u043a\u0430\u0436\u0434\u044b\u0435 5 \u0441\u0435\u043a\u0443\u043d\u0434\n```\n\n## \ud83d\udccb \u0422\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u044f\n\n- Python 3.8+\n- httpx >= 0.27.0\n- pydantic >= 2.0.0\n\n## \ud83d\udcc4 \u041b\u0438\u0446\u0435\u043d\u0437\u0438\u044f\n\nMIT License. \u0421\u043c. [LICENSE](LICENSE) \u0434\u043b\u044f \u0434\u0435\u0442\u0430\u043b\u0435\u0439.\n\n## \ud83e\udd1d \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430\n\n- \u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f: https://reghelp.net/api-docs\n- \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430: support@reghelp.net\n- Issues: https://github.com/REGHELPNET/reghelp_client/issues \n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2025 REGHelp Team Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "\u0421\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u0430\u044f \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u0430\u044f Python \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u0441 REGHelp Key API",
"version": "1.1.5",
"project_urls": {
"Bug Reports": "https://github.com/REGHELPNET/reghelp_client/issues",
"Documentation": "https://docs.reghelp.net/",
"Homepage": "https://github.com/REGHELPNET/reghelp_client",
"Source": "https://github.com/REGHELPNET/reghelp_client"
},
"split_keywords": [
"reghelp",
" api",
" client",
" async",
" push",
" email",
" telegram",
" integrity",
" recaptcha",
" turnstile",
" voip"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d63aed7b530c80c88dbf6a7e6e83f1fe681d4d7dbb131f93cfd03c740c021e9d",
"md5": "d8f7bd42bf9572580958db04ee160ae8",
"sha256": "c7224b5babe5ff2fece5c9c2eb86939116d9555b230fb208360031efb444c5a3"
},
"downloads": -1,
"filename": "reghelp_client-1.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d8f7bd42bf9572580958db04ee160ae8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 15747,
"upload_time": "2025-07-14T03:14:23",
"upload_time_iso_8601": "2025-07-14T03:14:23.549550Z",
"url": "https://files.pythonhosted.org/packages/d6/3a/ed7b530c80c88dbf6a7e6e83f1fe681d4d7dbb131f93cfd03c740c021e9d/reghelp_client-1.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a5ba18667e0f4f416e2978b163c7b51f887f04fd31bb9bb6dfa4bbadd020370d",
"md5": "c79e204d2de8983ff8401be3e809ef5a",
"sha256": "906e1579c328fda031f3f2bb9470c696e28b4dfce0597ba6eaf942c80bcef661"
},
"downloads": -1,
"filename": "reghelp_client-1.1.5.tar.gz",
"has_sig": false,
"md5_digest": "c79e204d2de8983ff8401be3e809ef5a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 19139,
"upload_time": "2025-07-14T03:14:25",
"upload_time_iso_8601": "2025-07-14T03:14:25.592989Z",
"url": "https://files.pythonhosted.org/packages/a5/ba/18667e0f4f416e2978b163c7b51f887f04fd31bb9bb6dfa4bbadd020370d/reghelp_client-1.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-14 03:14:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "REGHELPNET",
"github_project": "reghelp_client",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "httpx",
"specs": [
[
">=",
"0.27.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "typing-extensions",
"specs": [
[
">=",
"4.5.0"
]
]
}
],
"lcname": "reghelp-client"
}
