Rest API Динаміка акцій - datawizio/pythonAPI GitHub Wiki

40. Ресурс /sale-dynamics/ POST

Клієнти програми лояльності. З допомогою ресурсу /sale-dynamics/ можна отримати дані по акціях, відфільтрувати по даті, магазинах і т.д.

40.1. POST-параметри:

Назва поля Тип поля Доступні значення Значення за замовчуванням Опис
format рядок "json", "api" "json" Формат відповіді сервера
shops число, список - Всі магазини Ідентифікатор чи список ідентифікаторів магазинів
date_from рядок - Дата останньої підгрузки клієнта - 30 днів Початкова дата вибірки
date_to рядок - Дата останньої підгрузки клієнта Кінцева дата вибірки
sale_id число, список - Всі акції Ідентифікатор чи список ідентифікаторів акцій
select рядок, список "turnover", "receipts_qty" "turnover" Показники, по яких робити вибірку

40.1.2. Параметри відповіді:

Назва поля Тип поля Обов'якова наявність у відповіді Опис
date рядок так Дата вибірки
name рядок так Назва акції
turnover число ні Оборот акційних товарів
receipts_qty число ні К-сть чеків з акційними товарами

40.2. Приклад роботи з ресурсом

Команда: POST http://api.datawiz.io/api/v1/sale-dynamics/

Суфікси (аналог параметра format):
  • .json - отримати відповідь з сервера в форматі JSON
  • .api - отримати відповідь з сервера в форматі HTML (тестова платформа)
Приклад POST-параметрів:
{
  "sale_id": [1267, 245],
  "shops": 12
}
Відповідь сервера:

HTTP 200 OK
Content-Type: application/json
Vary: Accept
Allow: GET, HEAD, OPTIONS
{
  "results": [
    {
      "date": "2018-02-16",
      "name": "Акція №1",
      "receipts_qty": 2,
      "turnover": 23.38
    },
    {
      "date": "2018-02-17",
      "name": "Акція №1",
      "receipts_qty": 11,
      "turnover": 128.59
    },
    {
      "date": "2018-02-18",
      "name": "Акція №1",
      "receipts_qty": 7,
      "turnover": 81.83
    },
    {
      "date": "2018-02-19",
      "name": "Акція №1",
      "receipts_qty": 4,
      "turnover": 46.76
    },
    {
      "date": "2018-02-20",
      "name": "Акція №1",
      "receipts_qty": 1,
      "turnover": 11.69
    },
    {
      "date": "2018-02-22",
      "name": "Акція №2",
      "receipts_qty": 1,
      "turnover": 11.69
    },
    {
      "date": "2018-02-23",
      "name": "Акція №2",
      "receipts_qty": 1,
      "turnover": 11.69
    },
    {
      "date": "2018-02-24",
      "name": "Акція №2",
      "receipts_qty": 5,
      "turnover": 70.14
    },
    {
      "date": "2018-02-25",
      "name": "Акція №2",
      "receipts_qty": 2,
      "turnover": 23.38
    },
    {
      "date": "2018-02-26",
      "name": "Акція №2",
      "receipts_qty": 1,
      "turnover": 40.28
    },
    {
      "date": "2018-02-27",
      "name": "Акція №2",
      "receipts_qty": 1,
      "turnover": 45.75
    }
  ]
}
⚠️ **GitHub.com Fallback** ⚠️