Cascade предоставляет REST API. Ниже — практический минимум на Python с клиентом requests.
Полезные ссылки: API, send, verify, examples, FAQ, pricing, documentation.
Установка
pip install requests
Официального SDK может не быть — достаточно HTTP-клиента.
Инициализация
import os
import requests
BASE = os.getenv("OTP_API_BASE_URL", "https://otp.kztusdt.kz/api")
TOKEN = os.getenv("OTP_API_TOKEN")
HEADERS = {
"Authorization": f"Bearer {TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
}
def cascade(path: str, payload: dict) -> dict:
r = requests.post(f"{BASE}{path}", json=payload, headers=HEADERS, timeout=30)
return r.json()
Send
send = cascade("/otp/send", {"phone": "77001234567", "purpose": "verification"})
assert send.get("success"), send.get("message")
Verify
verify = cascade("/otp/verify", {"phone": "77001234567", "code": "482910", "purpose": "verification"})
assert verify.get("success"), verify.get("message")
Обрабатывайте success is False и HTTP 401/422/429. См. errors, FAQ, use-cases.