Базовый URL: https://plat-forma.com/pf_api/api.php
Авторизация проходит через X-Auth-Token: cGxhdC1mb3JtYWNybTEyMzo
Авторизация по догину - паролю пользователя.
Добавляет новую товарную позицию на склад.
Описать количество данных за 1 обращение
Content-Type | application/json |
Тело запроса: | { "id_sklad_pf": 2, "id_tovar": 123, "item_qty": 10, "item_price_retail": 100.50, "item_price_wholesale": 80.00, "is_item_damaged": 0, "coords": "55.638892,37.694845", "id_post": 5 } |
Обязательные поля: | id_sklad_pf - ID Склада Платформа (положительное целое число) id_tovar - ID товара Платформа (положительное целое число) item_qty - Количество товара (положительное целое число) |
Опциональные поля: | item_price_retail - Розничная цена (число ≥ 0) item_price_wholesale - Мелкий опт (число ≥ 0) is_item_damaged - Товар c повреждениями (0 или 1) coords - Координаты склада (строка) id_post - ID учетной системы поставщика (целое число) item_cost - Себестоимость (число ≥ 0) item_distributor - Дистрибьютор (строка) tem_dealer - Дилер (строка) item_big_wholesale - Крупный опт (число ≥ 0) item_mid_wholesale - Средний опт (число ≥ 0) item_price_base - Базовая цена (число ≥ 0) party_size - Размер партии (число ≥ 0) |
Успешный ответ (200): | { "success": true, "message": "Данные успешно добавлены", "insert_id": 12345 } |
Ошибки:
400 - Невалидные параметры
403 - Неверный токен аутентификации
409 - Дублирующаяся запись
429 - Превышен лимит запросов
500 - Ошибка сервера
2. Добавление товарной позиции (GET)
Параметры: | ?id_sklad_pf=2&id_tovar=123&item_qty=10 &item_price_retail=100.50&item_price_wholesale=80.00 &is_item_damaged=0&coords=55.638892,37.694845&id_post=5 |
Ответ | fналогичен POST |
Добавление товара (cURL) | curl -X POST "https://plat-forma.com/pf_api/api.php" \ -H "X-Auth-Token: cGxhdC1mb3JtYWNybTEyMzo" \ -H "Content-Type: application/json" \ -d '{ "id_sklad_pf": 2, "id_tovar": 1001, "item_qty": 50, "item_price_retail": 2999.99, "item_price_wholesale": 2500.00, "is_item_damaged": 0, "coords": "55.638892,37.694845", "id_post": 15 }' |
Добавление товара (JS) |
const response = await fetch('https://plat-forma.com/pf_api/api.php', { const result = await response.json(); |
Ограничения:
Rate limiting: 1 запрос в 6 секунд с одного IP
Формат данных: JSON для POST, параметры URL для GET
Описание функционала.
1. Перед загрузкой все данные удаляются
2. В профиле пользователя проставляется время жизни остатков
Альтернативный метод импорта через отправку xls на почту import@plat-forma.com