digiseller-api-python 1.5

Interaction with Digiseller API via Python

Digiseller API Python

Digiseller API Python — это библиотека Python для доступа к API Digiseller.

Добавлено 70 методов из числа представленных в документации.

Важное примечание: Данный проект не является официальным.
Я не имею никакого отношения к команде разработчиков сервиса Digiseller.

Возможны ошибки в некоторых запросах, так как комплексное тестирование не проводилось.
Часть запросов из документации на сайте Digiseller не соответствуют своему описанию.

Ознакомиться с документацией API вы можете на сайте Digiseller

Установка

Вы можете установить с сервиса PyPI

pip install digiseller-api-python

Для ручной установки с репозитория

pip3 install git+https://github.com/Ernieleo/digiseller-api-python.git

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

Получить API Ключ 👉тут👈
Получить ID Продавца 👉тут👈

from digiseller_api_python import Api

Digiseller_Api = Api(seller_id="11155533", api_key="CA1SF69A000A46D00039F01Z11017V39")

# Получение данных пользователя указанных при заказе по уникальному коду
def get_account_info_from_digiseller(unique_code):
    email = None
    password = None
    try:
        data = Digiseller_Api.unique_code(unique_code)
        
        for option in data["options"]:
            if option["name"] in ["Почта аккаунта ChatGPT", "ChatGPT account email"]:
                email = option["value"]
            elif option["name"] in ["Пароль аккаунта ChatGPT", "ChatGPT account password"]:
                password = option["value"]
    
        return email, password
    except Exception as e:
        ...

Используется для получения логина и пароля указанных покупателем при оформлении заказа в полях ввода (Параметры) текстовых данных.
Поиск требуемого поля осуществляется по названию, указывается названия поля на двух языках, название поля параметра полученного в сведениях о заказе, зависит от языка браузера пользователя.

Варианты ответов

Каждый метод возвращает исходный ответ от API сервера, за исключением случаев ошибки или отсутствия тела ответа в предусмотренных API случаях.
В случае ранее перечисленных причин или ошибке обработки ответа в формате json, будет возвращен данный ответ:

{
  "message": "Ошибка декодирования JSON", # Может быть иная причина.
  "http_code": 200, # Содержит HTTP Code ответа.
  "response": "Текст тела ответа при наличии"
}

Для успешного запроса без тела ответа:

{
  "message": "Запрос выполнен успешно", 
  "http_code": 200, 
  "response": "Нет ответа"
}

Для иных случаев возникновения ошибки в ходе работы, будет возвращено исключение.

from digiseller_api_python import Api

Digiseller_Api = Api(seller_id="11155533", api_key="CA1SF69A000A46D00039F01Z11017V39")

try:
    data = Digiseller_Api.categories_list(category_id=10, lang="ru-RU")
    ...
except Exception as error:
    print(error)

Разработка

Любой вклад в проект приветствуется.
Если вы хотите помочь в разработке, следуйте правилам API сервиса Digiseller и придерживайтесь общего стиля кода. Создайте запрос на cлияние и я его рассмотрю.

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

Cписок был сгенерирован при помощи ChatGPT, возможны неточности.
Каждая функция вызова описана в самом коде, смотрите информацию в IDE.

Параметры запросов с документации API, значения соответствуют.

1. Название: Получение токена для API

   • Функция: get_token
   • Ответ: Токен с жизнью 1 час 50 минут

2. Название: Поиск и проверка платежа по уникальному коду

   • Функция: unique_code
   • Параметры: unique_code: str
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

3. Название: Информация о продаже по номеру заказа

   • Функция: purchase_info
   • Параметры: invoice_id: int
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

4. Название: Список последних продаж

   • Функция: seller_last_sales
   • Параметры: group: bool, top: int
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

5. Название: Статистика продаж

   • Функция: seller_sells_statistic
   • Параметры: product_ids: list, date_start: str, date_finish: str, returned: int, page: int, rows: int
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

6. Название: Статистика продаж в роли агента

   • Функция: agent_sales_statistic
   • Параметры: product_ids: list, date_start: str, date_finish: str, returned: int, page: int, rows: int
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

7. Название: Список категорий (каталог)

   • Функция: categories_list
   • Параметры: category_id: int, lang: str
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

8. Название: Список товаров из категории

   • Функция: shop_products
   • Параметры: category_id: int, page: int, rows: int, order: str, currency: str, lang: str
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

9. Название: Быстрое получение описаний товаров по списку ID

   • Функция: products_description
   • Параметры: ids: list, lang: str
   • Ответ: Ответ от сервера в формате JSON
   • Ссылка на API

10. Название: Описание товара

    • Функция: product_description
    • Параметры: product_id: int, seller_id: int, partner_uid: str, currency: str, lang: str, owner: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

11. Название: Получение цены с учетом входящих значений параметров и/или количества товара

    • Функция: products_price_calc
    • Параметры: product_id: int, options: str, currency: str, amount: int, unit_cnt: int, count: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

12. Название: Отзывы о товарах

    • Функция: product_reviews
    • Параметры: seller_id: int, product_id: int, type_: str, owner_id: int, page: int, rows: int, lang: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

13. Название: Товары продавца

    • Функция: seller_goods
    • Параметры: seller_id: int, order_col: str, order_dir: str, rows: int, page: int, currency: str, lang: str, show_hidden: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

14. Название: Создание копии описания товара (клонирование без содержимого)

    • Функция: product_clone
    • Параметры: product_id: int, count: int, categories: bool, notify: bool, discounts: bool, options: bool, comissions: bool, gallery: bool
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

15. Название: Список товаров продавца с индивидуальным предложением

    • Функция: agents_offer
    • Параметры: seller_id: int, product_name: str, product_id: int, only_in_stock: bool, only_individual: bool, page: int, count: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

16. Название: Создание товара типа "Уникальный товар с фиксированной ценой"

    • Функция: product_create_uniquefixed
    • Параметры: data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

17. Название: Создание товара типа "Уникальный товар с нефиксированной ценой"

    • Функция: product_create_uniqueunfixed
    • Параметры: data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

18. Название: Создание товара типа "Электронная книга"

    • Функция: product_create_book
    • Параметры: data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ссылка на API

19. Название: Создание товара типа "Программное обеспечение"

    • Функция: product_create_software
    • Параметры: data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

20. Название: Создание товара типа "Произвольный цифровой товар"

    • Функция: product_create_arbitrary
    • Параметры: data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

21. Название: Редактирование товара типа "Уникальный товар с фиксированной ценой"

    • Функция: product_edit_uniquefixed
    • Параметры: product_id: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

22. Название: Редактирование товара типа "Уникальный товар с нефиксированной ценой"

    • Функция: product_edit_uniqueunfixed
    • Параметры: product_id: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

23. Название: Редактирование товара типа "Электронная книга"

    • Функция: product_edit_book
    • Параметры: product_id: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

24. Название: Редактирование товара типа "Программное обеспечение"

    • Функция: product_edit_software
    • Параметры: product_id: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

25. Название: Редактирование товара типа "Произвольный цифровой товар"

    • Функция: product_edit_arbitrary
    • Параметры: product_id: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

26. Название: Редактирование базовых свойств товара. Включение/выключение товара

    • Функция: product_edit_base
    • Параметры: product_id: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

27. Название: Добавление изображений товара

    • Функция: product_preview_add_images
    • Параметры: product_id: int, files
    • Примечание: Files: {'image.jpeg': open('pic.jpeg', 'rb')}
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

28. Название: Добавление youtube-ссылок в галерею

    • Функция: product_preview_add_videos
    • Параметры: product_id: int, files
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

29. Название: Изменение позиции и удаление изображений в галерее

    • Функция: product_preview_options
    • Параметры: type_: str, preview_id: int, enabled: bool, index: int, delete: bool
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

30. Название: Массовое обновление статуса товаров

    • Функция: product_edit_v2
    • Параметры: new_status: str, products: list
    • Примечание: (list): ID товаров. Не более 200 товаров в 1 запросе: ["123", "345"]
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

31. Название: Добавление товара в подкатегорию торговой площадки

    • Функция: product_platform_category_add
    • Параметры: product_id: int, platforms: list
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

32. Название: Получение дерева категорий торговой площадки

    • Функция: dictionary_platforms_categories
    • Параметры: id_: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

33. Название: Получение подкатегорий торговой площадки

    • Функция: dictionary_platforms_subcategories
    • Параметры: id_: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

34. Название: Массовое изменение цен товаров

    • Функция: product_edit_prices
    • Параметры: data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

35. Название: Получение статуса выполнения асинхронной задачи

    • Функция: product_edit_update_products_tasks_status
    • Параметры: task_id: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

36. Название: Метод добавления содержимого типа "Файл"

    • Функция: product_content_add_file
    • Параметры: product_id: int, file
    • Примечание: File: files = {'text.txt': open('passwords.txt', 'rb')}
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

37. Название: Метод добавления содержимого типа "Файл" с распаковкой ZIP-архива (до 200 файлов)

    • Функция: product_content_add_files
    • Параметры: product_id: int, count: int, files
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

38. Название: Добавление содержимого типа "текст" или "ссылка"

    • Функция: product_content_add_text
    • Параметры: data: dict
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

39. Название: Изменение количества генерируемых кодов Digiseller

    • Функция: product_content_add_code
    • Параметры: product_id: int, count: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

40. Название: Метод редактирования содержимого типа "Файл"

    • Функция: product_content_update_file_v2
    • Параметры: files: dict, content_id: int, product_id: int, update_old: bool
    • Примечание: files = { '1': ('image1.jpeg', open('1.jpeg', 'rb')), '2': ('image2.jpeg', open('2.jpeg', 'rb')) }
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

41. Название: Редактирование содержимого типа "текст" или "ссылка"

    • Функция: product_content_update_text
    • Параметры: content_id: int, serial: str, value: str, update_old: bool, product_id: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

42. Название: Удаление содержимого типа "текст", "ссылка" или "файл"

    • Функция: product_content_delete
    • Параметры: content_id: int, product_id: int
    • Ответ: StatusCode: 204 (NoContent)
    • Ссылка на API

43. Название: Полное удаление содержимого типа "текст", "ссылка" или "файл"

    • Функция: product_content_delete_all
    • Параметры: product_id: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

44. Название: Создание или редактирование содержимого типа "форма"

    • Функция: product_content_update_form
    • Параметры: product_id: int, address: str, method: str, encoding: str, options: bool, answer: bool, allow_purchase_multiple_items: bool, url_for_quantity: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

45. Название: Cоздание шаблона комиссионных отчислений

    • Функция: templates
    • Параметры: name: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

46. Название: Изменение шаблона комиссионных отчислений

    • Функция: templates_edit
    • Параметры: name: str, id_: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

47. Название: Получение списка шаблонов отчислений

    • Функция: templates_list
    • Параметры: page: int, count: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

48. Название: Удаление шаблона комиссионных отчислений

    • Функция: templates_delete
    • Параметры: id_: int, method: str = "POST"
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

49. Название: Получение списка товаров из шаблона отчислений

    • Функция: templates_products
    • Параметры: template_id: int, product_id: int, price_min: float, price_max: float, currency: str, language: str, name: str, min_comiss: float, max_comiss: float, in_affiliate: bool, not_in_affiliate: bool, only_payment: bool, page: int, count: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

50. Название: Обновление товаров в шаблоне отчислений

    • Функция: update_template_products
    • Параметры: data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: StatusCode: 204 (NoContent)
    • Ссылка на API

51. Название: Применение шаблона отчислений

    • Функция: template_apply
    • Параметры: template_id: int, seller_id: int
    • Ответ: StatusCode: 204 (NoContent)
    • Ссылка на API

52. Название: Список параметров товара

    • Функция: products_options_list
    • Параметры: product_id: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

53. Название: Информация о параметре

    • Функция: products_options_info
    • Параметры: option_id: int
    • Ответ: Ответ от сервера в формате JSON
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

54. Название: Создание параметра

    • Функция: products_options_add
    • Параметры: name_ru: str, name_en: str, comment_ru: str, comment_en: str, ptype: str, separate_content: bool, required: bool, modifier_visible: bool, order: int, product_id: int, variant_dict: dict
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

55. Название: Редактирование параметра

    • Функция: products_options_update
    • Параметры: name_ru: str, name_en: str, ptype: str, separate_content: bool, required: bool, modifier_visible: bool, order: int, option_id: int, comment_ru: str, comment_en: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

56. Название: Удаление параметра

    • Функция: products_options_delete
    • Параметры: option_id: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

57. Название: Создание варианта

    • Функция: products_variant_add
    • Параметры: option_id: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

58. Название: Редактирование варианта

    • Функция: products_variant_edit
    • Параметры: option_id: int, variant_id: int, name_ru: str, name_en: str, ptype: str, rate: int, default: bool, visible: bool, order: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

59. Название: Удаление варианта

    • Функция: products_variant_delete
    • Параметры: option_id: int, variant_id: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

60. Название: Получение списка диалогов

    • Функция: chat_list
    • Параметры: filter_new: int, email: str, id_ds: str, pagesize: int, page: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

61. Название: Получение статуса диалога

    • Функция: chat_status
    • Параметры: id_i: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

62. Название: Изменение статуса диалога

    • Функция: chat_edit_status
    • Параметры: id_i: int, chat_state: int
    • Ответ: 'StatusCode: 200 (NoContent)'
    • Ссылка на API

63. Название: Получение списка сообщений

    • Функция: chat_order_messages
    • Параметры: id_i: int, hidden: int, id_from: int, id_to: int, old_id: int, newer: int, count: int
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

64. Название: Установка флага прочитан

    • Функция: chat_set_flag
    • Параметры: id_i: int
    • Ответ: StatusCode: 200 (NoContent)
    • Ссылка на API

65. Название: Предварительная загрузка файлов

    • Функция: chat_upload_preview
    • Параметры: files, lang: str
    • Примечание: Files: [('files[]', ('file': open(file_path, 'rb'))]
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

66. Название: Отправка нового сообщения

    • Функция: chat_send_message
    • Параметры: id_i: int, data: dict
    • Примечание: Формат запроса (Data) указан в Документации API. См. Ссылка на API
    • Ответ: StatusCode: 200 (NoContent)
    • Ссылка на API

67. Название: Удаление сообщения

    • Функция: chat_delete_message
    • Параметры: order_id: int, message_id: int
    • Ответ: [] (NoContent)
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

68. Название: Реклама на площадке

    • Функция: rekl
    • Параметры: owner: int, date: str, lang: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

69. Название: Операции по личному счету Digiseller

    • Функция: sellers_account_receipts
    • Параметры: page: int, count: int, currency: str, types: list, code_filter: str, allowtype: str, start: str, finish: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

70. Название: Операции через внешних агрегаторов

    • Функция: sellers_account_receipts_external
    • Параметры: page: int, count: int, order: str, code: str, aggregator: str
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API

71. Название: Информация о балансе личного счёта

    • Функция: sellers_account_balance
    • Параметры: Передача не требуется
    • Ответ: Ответ от сервера в формате JSON
    • Ссылка на API