smsru-api 1.4

[A]sync Python API для сервиса отправки сообщений sms.ru

SMS.RU API

Синхронный и асинхронный Python API для сервиса отправки сообщений sms.ru

Python Versions

License

Кратко

smsru_api предоставляет:

• Client для синхронной работы с API sms.ru
• AsyncClient для асинхронного кода
• обратную совместимость через SmsRu и AsyncSmsRu

Библиотека покрывает:

• отправку SMS через send()
• расчет стоимости через cost()
• проверку статуса через status()
• авторизацию по звонку через callcheck_add() и callcheck_status()
• методы аккаунта balance(), limit(), free(), senders()
• стоп-лист и callback URL

Установка

pip install smsru-api

Быстрый старт

from smsru_api import Client

smsru = Client("YOUR_API_KEY")
response = smsru.send("79990000000", message="Привет от sms.ru", debug=True)
print(response)

Асинхронный вариант:

from smsru_api import AsyncClient

smsru = AsyncClient("YOUR_API_KEY")
response = await smsru.balance()

Важные особенности

• можно передавать один текст на несколько номеров или словарь multi
• за один запрос допускается не более 100 получателей
• номера очищаются от нецифровых символов и ведущего +7 или 8
• debug=True включает тестовый режим, если test не указан явно
• ttl должен быть в диапазоне от 1 до 1440

Подробная документация

Подробное руководство хранится в репозитории:

• README.md — быстрый старт
• docs/README.md — полная документация

Ссылки

• GitHub: smsru_api
• PyPI: smsru-api