Rest API Аналіз корзин - datawizio/pythonAPI GitHub Wiki

41. Ресурс /pairs/ POST

Аналіз корзин. З допомогою ресурсу /pairs/ можна визначити типові корзини покупців у торговій мережі в різний час, різної вартості та розміру.

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

Назва поля Тип поля Доступні значення Значення за замовчуванням Опис
format рядок "json", "api" "json" Формат відповіді сервера
product_id число - Всі товари Ідентифікатор товару
category_id число - Всі категорії Ідентифікатор категорії
level число - 1 Рівень для аналізу, починаючи з першого (категорії -> підкатегорії -> .. -> товари)
shops число, список - Всі магазини Ідентифікатор магазину
hours число, список 0 - 23 Весь день Години, за якими здійснюється вибірка
price_from число - 0 Мінімальна ціна товару
price_to число - 10000 Максимальна ціна товару
week_day число, рядок 0 - 6, "all" "all" День тижня, по якому здійснюється вибірка
date_from рядок - Дата останньої підгрузки клієнта - 30 днів Початкова дата вибірки
date_to рядок - Дата останньої підгрузки клієнта Кінцева дата вибірки
interval рядок "days", "weeks", "months", "years" "days" Інтервал для вибірки

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

Назва поля Тип поля Обов'язкова наявність у відповіді Опис
product_1 число так Ідентифікатор супутнього товару
product_2 число ні Ідентифікатор супутнього товару
product_... число ні Ідентифікатор супутнього товару
product_5 число ні Ідентифікатор супутнього товару
product_1_name число так Назва супутнього товару
product_2_name число ні Назва супутнього товару
product_..._name число ні Назва супутнього товару
product_5_name число ні Назва супутнього товару
confidence число так Достовірність
support число так Підтримка
receipts_qty число так К-сть чеків, в яких зустрічається типова корзина
avg_number_of_items_in_check число так Середній розмір чеків з типовою корзиною
avg_receipt число так Середня вартість чеків, в які потрапила типова корзина

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

Команда: POST http://api.datawiz.io/api/v1/pairs/

Суфікси (аналог параметру format):
  • .json - отримати відповідь з сервера в форматі JSON
  • .api - отримати відповідь з сервера в форматі HTML (тестова платформа)
Приклад POST-параметрів:
{
  "shops": 674,
  "price_from": 10,
  "price_to": 200,
  "category_id": 75100,
  "level": 2
}
Відповідь сервера:

HTTP 200 OK
Content-Type: application/json
Vary: Accept
Allow: GET, HEAD, OPTIONS
{
  "results": [
    {
      "confidence": 13.12,
      "product_2": "77226",
      "product_1": "76805",
      "support": 0.01621,
      "product_1_name": "Овочі",
      "avg_number_of_items_in_check": 5.68,
      "receipts_qty": 10623,
      "avg_receipt": 127.84,
      "id": "76805-77226",
      "product_2_name": "Хлібобулочні вироби"
    },
    {
      "confidence": 13.3,
      "product_2": "76174",
      "product_1": "75642",
      "support": 0.01643,
      "product_1_name": "Бакалія (солена)",
      "avg_number_of_items_in_check": 6.02,
      "receipts_qty": 10768,
      "avg_receipt": 136.07,
      "id": "75642-76174",
      "product_2_name": "Бакалія (солодка)"
    },
    {
      "confidence": 15.23,
      "product_2": "76174",
      "product_1": "76805",
      "support": 0.01882,
      "product_1_name": "Овочі",
      "avg_number_of_items_in_check": 6.02,
      "receipts_qty": 12332,
      "avg_receipt": 137.7,
      "id": "76805-76174",
      "product_2_name": "Бакалія (солена)"
    },
    {
      "confidence": 13.05,
      "product_2": "75642",
      "product_1": "76805",
      "support": 0.01612,
      "product_1_name": "Овочі",
      "avg_number_of_items_in_check": 5.95,
      "receipts_qty": 10561,
      "avg_receipt": 142.98,
      "id": "76805-75642",
      "product_2_name": "Бакалія (солодка)"
    }
  ]
}
⚠️ **GitHub.com Fallback** ⚠️