pyucallerapi - Python service for convenient work with uCaller API

Documentation uCaller api: DOC

Установка

pip install pyucallerapi

python>=3.10
requests
pydantic>=2.9.2

Как использовать

UCallerAPI - с всеми доступными методами 
SettingAPI - только методы для работы с аккаунтом
CallAPI - только запросы кода авторизации

api = UCallerAPI(service_id=service_id,key=key, return_dict=True)
# Либо
api = UCallerAPI(service_id=service_id,key=key,)
api.return_dict = True

Example

Использование сервиса

import logging
from pyucallerapi import APIUCaller, CallAPI, SettingAPI
logger = logging.getLogger(__name__)
logging.basicConfig(filename='example.log', encoding='utf-8', level=logging.DEBUG)
service_id = <int>
key = ""
# запрашиваем звонок 
api = APIUCaller(
 service_id=service_id,
 key=key,
 logger=logger
)
# Проверка работоспособности сервиса -> HealthModel | ErrorResponseModel
api.health()
# Запрос на авторизацию -> InitCallModel | ErrorResponseModel
out = api.init_call("+79000000001", "6123",) 
# получить информацию о запросе авторизации 
api.get_info(out.ucaller_id)

Получение данных webhook (например, из FastAPI)

from fastapi import APIRouter, Request
from pyucallerapi import UcallerWebhookModel 
router = APIRouter()
@router.post("/ucaller-webhook")
async def handle_webhook(request: Request):
 data = await request.json()
 webhook = UcallerWebhookRequest(**data) # Валидация
 
if webhook.isMnp:
 print(f"Номер портирован от {webhook.operatorName} к {webhook.operatorNameMnp}")
return {"status": "ok"}