Skip to main content

API wrapper for Sferum platform

Project description

SferumAPI

SferumAPI — это Python-библиотека, предоставляющая удобный интерфейс для работы с закрытым API Сферума. Она упрощает выполнение рутинных задач и позволяет легко интегрировать функционал Сферума в ваши проекты.


Функционал

Функция Статус
🔑 Авторизация пользователя в Сферуме
🔑 Авторизация сессии для звонков
✉️ Отправка сообщений пользователю
📥 Получение сообщений из чатов
📥 Получение сообщений из каналов
📞 Создание групповых звонков
🔗 Подключение к групповым звонкам
🛑 Завершение групповых звонков
📞 Создание личных звонков
🔗 Подключение к личным звонкам
🛑 Завершение личных звонков
📢 Отправка сообщений в каналы

✅ — Реализовано
❌ — В планах
❓ — Под вопросом


Зачем создана?

Каждую неделю приходится вручную выполнять норму по сообщениям и звонкам. Это рутинная и скучная задача, для которой не существовало готовых инструментов автоматизации. SferumAPI решает эту проблему, делая процесс быстрым и удобным.


Установка

Установите библиотеку через pip:

pip install SferumAPI

Или клонируйте репозиторий и установите её локально:

git clone https://github.com/l2700l/SferumAPI
cd SferumAPI
pip install .

Пример использования

import SferumAPI

# Инициализация

remixdsid = "" # значение берется из cookies
api = SferumAPI.SferumAPI(remixdsid=remixdsid)

# Получение историй сообщений

messages_history = api.messages.get_history(peer_id=0, count=1, offset=0) # peer_id - id чата в Сферум
print(messages_history.response.items[0].text)

channel_history = api.channels.get_history(channel_id=-1, count=1, offset=0)
print(channel_history.response.items[0].attachments[0].wall.attachments[0].photo.sizes[0].url)

# Звонки

api.calls.peer.set_peer_id(peer_id=0) # peer_id - id пользователя в Сферум
api.calls.peer.start()
input()
api.calls.peer.end()

# Отправка сообщения

api.messages.send_message(peer_id=0, text="SferumAPI") # peer_id - id пользователя в Сферум

Обратная связь и вклад в развитие

Если у вас есть предложения по улучшению или вы нашли ошибку, создайте issue в репозитории. Pull requests приветствуются!

Разработано с заботой о преподавателей и учителей ❤️

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sferumapi-0.1.0.tar.gz (13.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

SferumAPI-0.1.0-py3-none-any.whl (23.2 kB view details)

Uploaded Python 3

File details

Details for the file sferumapi-0.1.0.tar.gz.

File metadata

  • Download URL: sferumapi-0.1.0.tar.gz
  • Upload date:
  • Size: 13.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for sferumapi-0.1.0.tar.gz
Algorithm Hash digest
SHA256 9310c5f8cfbedf3fe6485649b7e0243dbc0c22d74518119d051208476220999d
MD5 7d9fd5a205e26d062406de0bf736f144
BLAKE2b-256 504e52596dc88821cc8a2de993b1b8fa153b0cb04ef81c23ce9db445b1a8b4d7

See more details on using hashes here.

File details

Details for the file SferumAPI-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: SferumAPI-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 23.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for SferumAPI-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 001deb74019b191568103d202a2762edf9c0bf403afbe77b50e9c3973b961868
MD5 7292d8da1d1ae9f8ab5fc3f4b20c72fb
BLAKE2b-256 123d95fa132027a92448d6b9babbc216961d20e8662fe44b97d36f51ae4e405f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page