Как интегрировать REGHelp API: пошаговое руководство
Это руководство проведёт вас через интеграцию REGHelp API в ваше приложение — от получения API-ключа до обработки ответов в продакшене.
Шаг 1: Получите API-ключ
- Зарегистрируйтесь в REGHelp
- Перейдите на страницу профиля
- Скопируйте API-ключ из дашборда
- Пополните баланс
Шаг 2: Первый запрос
Все API-запросы используют метод GET с apiKey в query-параметрах:
curl "https://api.reghelp.net/push/getToken?apiKey=ВАШ_КЛЮЧ&appName=tgiOS&appDevice=iOS"
Шаг 3: Обработка ответов
Создание задачи (*/getToken):
{
"id": "664462c0f45c5b1b760b7c3e",
"service": "tg",
"product": "push",
"price": 0.75,
"balance": 122.50,
"status": "success"
}
Получение статуса (*/getStatus):
{
"id": "664462c0f45c5b1b760b7c3e",
"status": "done",
"token": "1673463060517848736:APA91b...",
"message": "OK"
}
Значения status:
done— задача выполнена успешноwait/pending— задача обрабатываетсяerror— ошибка (проверьте полеmessage)
Шаг 4: Обработка ошибок
import asyncio
from reghelp_client import RegHelpClient, AppDevice
async def get_push_token():
async with RegHelpClient("ВАШ_API_КЛЮЧ") as client:
task = await client.get_push_token("tgiOS", AppDevice.IOS)
result = await client.wait_for_result(task.id, "push")
print(result.token)
asyncio.run(get_push_token())
Или напрямую через HTTP:
import httpx
async def create_push_token(api_key: str, app_name: str, app_device: str):
async with httpx.AsyncClient() as client:
resp = await client.get(
"https://api.reghelp.net/push/getToken",
params={"apiKey": api_key, "appName": app_name, "appDevice": app_device},
)
data = resp.json()
task_id = data["id"]
# Опрашиваем статус
for _ in range(60):
resp = await client.get(
"https://api.reghelp.net/push/getStatus",
params={"apiKey": api_key, "id": task_id},
)
result = resp.json()
if result["status"] == "done":
return result["token"]
await asyncio.sleep(3)
Лимиты
- Rate limit на пару API-ключ / IP (HTTP 429 при превышении)
- Используйте экспоненциальную задержку для повторов
SDK
Официальная Python-библиотека:
pip install reghelp_client