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.1.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.1-py3-none-any.whl (23.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sferumapi-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 ea32ffef66c6e107a4da5db39506addff9ab645d839a79c87c51989e0d0d4df5
MD5 05d8c2cade9515968bf2f04cbe4999af
BLAKE2b-256 ae527f5ba1c31c0e8740f3d6433c78f7680bc746947864bbeed3d1752c685db8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: SferumAPI-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c7969e905bfc0532fa1bb484c01a78656035787d82c998f5d296f0e3520223dc
MD5 a3116db4882d1ffc12509c971a6517ae
BLAKE2b-256 0fcfb5cd044505f4035e611be5b163ed87bed779ea71b023ad61d387987ece35

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