digiseller

Name	digiseller JSON
Version	0.0.7 JSON
	download
home_page	https://github.com/onyx256/digiseller
Summary	Digiseller API wrapper
upload_time	2024-11-19 22:27:37
maintainer	None
docs_url	None
author	slava256
requires_python	>=3.11
license	None
keywords	digiseller
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Digiseller

[![PyPi version](https://badgen.net/pypi/v/digiseller/)](https://pypi.org/project/digiseller)
[![Загрузки](https://img.shields.io/pypi/dm/digiseller.svg)](https://pypistats.org/packages/digiseller)
[![CodeFactor](https://www.codefactor.io/repository/github/onyx256/digiseller/badge)](https://www.codefactor.io/repository/github/onyx256/digiseller)

Неофициальная библиотека - Digiseller API wrapper для Python. Простой и удобный способ взаимодействовать с АПИ сервиса.

## Установка

Установить можно используя **pip**:
```sh
pip install digiseller
```

Или напрямую с **GitHub**:
```sh
pip install git+https://github.com/onyx256/digiseller.git
```

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

Пример использования библиотеки: заработок с последних 10 продаж

```python
from digiseller import Digiseller

seller_id = 123456  # https://my.digiseller.com/inside/my_info.asp?rnd=4324
api_key = 'EXAMPLE'  # https://my.digiseller.com/inside/api_keys.asp
digi = Digiseller(seller_id, api_key)

latest_sales = digi.statistics.get_latest_sales(group=False, top=10)  # Отключаем группировку по товарам, указываем top=10 чтобы получить последние 10 продаж

sales_sum = 0
for sale in latest_sales:
    sales_sum += sale.price_rub  # Имена атрибутов класса Sale соответствуют параметрам возвращаемым с API

print(f'Заработок с последних 10 продаж: {sales_sum} RUB')
```

## Доступные методы

Библиотека в разработке, доступно небольшое количество методов. **Список доступных на данный момент методов представлен ниже:**

### Статистика (api.Statistics)

- **Получение списка последних продаж**
    https://my.digiseller.com/inside/api_statistics.asp#last_sales
    ```python
    Digiseller.statistics.get_latest_sales()
    ```

- **Получение подробной статистики продаж**
    https://my.digiseller.com/inside/api_statistics.asp#last_sales

    ```python
    Digiseller.statistics.get_sales()
    ```

- **Получение статистики по продажам в качестве агента**
    https://my.digiseller.com/inside/api_statistics.asp#statistics_agent_sales

    ```python
    Digiseller.statistics.get_sales_as_agent()
    ```

### Операции (api.Operations)

- **Получение списка операций по аккаунту**
    https://my.digiseller.com/inside/api_account.asp#digiseller
    ```python
    Digiseller.operations.get_all()
    ```

- **Получение списка операций проведенных через внешних агрегаторов**
    https://my.digiseller.com/inside/api_account.asp#external

    ```python
    Digiseller.operations.external_aggregators()
    ```

- **Получение баланса личного счета**
    https://my.digiseller.com/inside/api_account.asp#view_balance

    ```python
    Digiseller.operations.get_balance()
    ```

### Товары (api.Products)

- **Получение списка категорий и их подкатегорий**
    https://my.digiseller.com/inside/api_catgoods.asp#categories
    ```python
    Digiseller.products.get_categories()
    ```

- **Получение списка товаров из категории**
    https://my.digiseller.com/inside/api_catgoods.asp#products
    ```python
    Digiseller.products.get_all_by_category()
    ```

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/onyx256/digiseller",
    "name": "digiseller",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "digiseller",
    "author": "slava256",
    "author_email": "sv2021e@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/c3/8e/6cb549ed1af8c05eae68340fe499039a10803133840ede09137d43c4a7c7/digiseller-0.0.7.tar.gz",
    "platform": null,
    "description": "# Digiseller\r\n\r\n[![PyPi version](https://badgen.net/pypi/v/digiseller/)](https://pypi.org/project/digiseller)\r\n[![\u0417\u0430\u0433\u0440\u0443\u0437\u043a\u0438](https://img.shields.io/pypi/dm/digiseller.svg)](https://pypistats.org/packages/digiseller)\r\n[![CodeFactor](https://www.codefactor.io/repository/github/onyx256/digiseller/badge)](https://www.codefactor.io/repository/github/onyx256/digiseller)\r\n\r\n\u041d\u0435\u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u0430\u044f \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 - Digiseller API wrapper \u0434\u043b\u044f Python. \u041f\u0440\u043e\u0441\u0442\u043e\u0439 \u0438 \u0443\u0434\u043e\u0431\u043d\u044b\u0439 \u0441\u043f\u043e\u0441\u043e\u0431 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u0441 \u0410\u041f\u0418 \u0441\u0435\u0440\u0432\u0438\u0441\u0430.\r\n\r\n## \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\r\n\r\n\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c \u043c\u043e\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f **pip**:\r\n```sh\r\npip install digiseller\r\n```\r\n\r\n\u0418\u043b\u0438 \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e \u0441 **GitHub**:\r\n```sh\r\npip install git+https://github.com/onyx256/digiseller.git\r\n```\r\n\r\n## \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\r\n\r\n\u041f\u0440\u0438\u043c\u0435\u0440 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438: \u0437\u0430\u0440\u0430\u0431\u043e\u0442\u043e\u043a \u0441 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0445 10 \u043f\u0440\u043e\u0434\u0430\u0436\r\n\r\n```python\r\nfrom digiseller import Digiseller\r\n\r\nseller_id = 123456  # https://my.digiseller.com/inside/my_info.asp?rnd=4324\r\napi_key = 'EXAMPLE'  # https://my.digiseller.com/inside/api_keys.asp\r\ndigi = Digiseller(seller_id, api_key)\r\n\r\nlatest_sales = digi.statistics.get_latest_sales(group=False, top=10)  # \u041e\u0442\u043a\u043b\u044e\u0447\u0430\u0435\u043c \u0433\u0440\u0443\u043f\u043f\u0438\u0440\u043e\u0432\u043a\u0443 \u043f\u043e \u0442\u043e\u0432\u0430\u0440\u0430\u043c, \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c top=10 \u0447\u0442\u043e\u0431\u044b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0435 10 \u043f\u0440\u043e\u0434\u0430\u0436\r\n\r\nsales_sum = 0\r\nfor sale in latest_sales:\r\n    sales_sum += sale.price_rub  # \u0418\u043c\u0435\u043d\u0430 \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u043e\u0432 \u043a\u043b\u0430\u0441\u0441\u0430 Sale \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u044e\u0442 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c\u044b\u043c \u0441 API\r\n\r\nprint(f'\u0417\u0430\u0440\u0430\u0431\u043e\u0442\u043e\u043a \u0441 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0445 10 \u043f\u0440\u043e\u0434\u0430\u0436: {sales_sum} RUB')\r\n```\r\n\r\n## \u0414\u043e\u0441\u0442\u0443\u043f\u043d\u044b\u0435 \u043c\u0435\u0442\u043e\u0434\u044b\r\n\r\n\u0411\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u0432 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435, \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u043e \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u043c\u0435\u0442\u043e\u0434\u043e\u0432. **\u0421\u043f\u0438\u0441\u043e\u043a \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b\u0445 \u043d\u0430 \u0434\u0430\u043d\u043d\u044b\u0439 \u043c\u043e\u043c\u0435\u043d\u0442 \u043c\u0435\u0442\u043e\u0434\u043e\u0432 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u0435\u043d \u043d\u0438\u0436\u0435:**\r\n\r\n### \u0421\u0442\u0430\u0442\u0438\u0441\u0442\u0438\u043a\u0430 (api.Statistics)\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0441\u043f\u0438\u0441\u043a\u0430 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0445 \u043f\u0440\u043e\u0434\u0430\u0436**\r\n    https://my.digiseller.com/inside/api_statistics.asp#last_sales\r\n    ```python\r\n    Digiseller.statistics.get_latest_sales()\r\n    ```\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0439 \u0441\u0442\u0430\u0442\u0438\u0441\u0442\u0438\u043a\u0438 \u043f\u0440\u043e\u0434\u0430\u0436**\r\n    https://my.digiseller.com/inside/api_statistics.asp#last_sales\r\n\r\n    ```python\r\n    Digiseller.statistics.get_sales()\r\n    ```\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0441\u0442\u0430\u0442\u0438\u0441\u0442\u0438\u043a\u0438 \u043f\u043e \u043f\u0440\u043e\u0434\u0430\u0436\u0430\u043c \u0432 \u043a\u0430\u0447\u0435\u0441\u0442\u0432\u0435 \u0430\u0433\u0435\u043d\u0442\u0430**\r\n    https://my.digiseller.com/inside/api_statistics.asp#statistics_agent_sales\r\n\r\n    ```python\r\n    Digiseller.statistics.get_sales_as_agent()\r\n    ```\r\n\r\n### \u041e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 (api.Operations)\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0441\u043f\u0438\u0441\u043a\u0430 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439 \u043f\u043e \u0430\u043a\u043a\u0430\u0443\u043d\u0442\u0443**\r\n    https://my.digiseller.com/inside/api_account.asp#digiseller\r\n    ```python\r\n    Digiseller.operations.get_all()\r\n    ```\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0441\u043f\u0438\u0441\u043a\u0430 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0439 \u043f\u0440\u043e\u0432\u0435\u0434\u0435\u043d\u043d\u044b\u0445 \u0447\u0435\u0440\u0435\u0437 \u0432\u043d\u0435\u0448\u043d\u0438\u0445 \u0430\u0433\u0440\u0435\u0433\u0430\u0442\u043e\u0440\u043e\u0432**\r\n    https://my.digiseller.com/inside/api_account.asp#external\r\n\r\n    ```python\r\n    Digiseller.operations.external_aggregators()\r\n    ```\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0431\u0430\u043b\u0430\u043d\u0441\u0430 \u043b\u0438\u0447\u043d\u043e\u0433\u043e \u0441\u0447\u0435\u0442\u0430**\r\n    https://my.digiseller.com/inside/api_account.asp#view_balance\r\n\r\n    ```python\r\n    Digiseller.operations.get_balance()\r\n    ```\r\n\r\n### \u0422\u043e\u0432\u0430\u0440\u044b (api.Products)\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0441\u043f\u0438\u0441\u043a\u0430 \u043a\u0430\u0442\u0435\u0433\u043e\u0440\u0438\u0439 \u0438 \u0438\u0445 \u043f\u043e\u0434\u043a\u0430\u0442\u0435\u0433\u043e\u0440\u0438\u0439**\r\n    https://my.digiseller.com/inside/api_catgoods.asp#categories\r\n    ```python\r\n    Digiseller.products.get_categories()\r\n    ```\r\n\r\n- **\u041f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u0435 \u0441\u043f\u0438\u0441\u043a\u0430 \u0442\u043e\u0432\u0430\u0440\u043e\u0432 \u0438\u0437 \u043a\u0430\u0442\u0435\u0433\u043e\u0440\u0438\u0438**\r\n    https://my.digiseller.com/inside/api_catgoods.asp#products\r\n    ```python\r\n    Digiseller.products.get_all_by_category()\r\n    ```\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Digiseller API wrapper",
    "version": "0.0.7",
    "project_urls": {
        "GitHub": "https://github.com/onyx256/digiseller",
        "Homepage": "https://github.com/onyx256/digiseller"
    },
    "split_keywords": [
        "digiseller"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0f6ffd456d9d9488df8df99dd6b7d88b7e3402aac5b3b6342108f5399495b7b8",
                "md5": "4e9ef354ba7290f7ff22af18a514caf0",
                "sha256": "781f5d1b0e95a860c6af42f67749e6c929aea5743683c60e24c1c148ef233b84"
            },
            "downloads": -1,
            "filename": "digiseller-0.0.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4e9ef354ba7290f7ff22af18a514caf0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 13008,
            "upload_time": "2024-11-19T22:27:36",
            "upload_time_iso_8601": "2024-11-19T22:27:36.031832Z",
            "url": "https://files.pythonhosted.org/packages/0f/6f/fd456d9d9488df8df99dd6b7d88b7e3402aac5b3b6342108f5399495b7b8/digiseller-0.0.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c38e6cb549ed1af8c05eae68340fe499039a10803133840ede09137d43c4a7c7",
                "md5": "aa4225f87176869035865f504b5e3f97",
                "sha256": "82cc9e2aeb41b27dbacad6c728720d13b5732cd5d2d083d5370a4c700a3cea2d"
            },
            "downloads": -1,
            "filename": "digiseller-0.0.7.tar.gz",
            "has_sig": false,
            "md5_digest": "aa4225f87176869035865f504b5e3f97",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 10448,
            "upload_time": "2024-11-19T22:27:37",
            "upload_time_iso_8601": "2024-11-19T22:27:37.444280Z",
            "url": "https://files.pythonhosted.org/packages/c3/8e/6cb549ed1af8c05eae68340fe499039a10803133840ede09137d43c4a7c7/digiseller-0.0.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-19 22:27:37",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "onyx256",
    "github_project": "digiseller",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "digiseller"
}