Отличные расширения для Opencart с надёжной поддержкой

Созданы для эффективности, поставляются с уверенностью
Каталог расширений Смотреть
Получить поддержку Помогите мне
Факты, которые подтверждают наше внимание к качеству и поддержке

Более 10 лет опыта

Мы больше десяти лет создаём надёжные расширения для OpenCart и знаем, что нужно вашему магазину.

Открытый код, легко изменять

Чистый, понятный код. Все расширения поставляются с открытым исходным кодом и легко настраиваются.

Гарантия возврата денег и поддержка

Не устроило? Полный возврат средств в течение 30 дней. Поддержка отвечает в течение 72 часов.

Бесплатные обновления и помощь с совместимостью

Пожизненные обновления в пределах мажорной версии OpenCart. Бесплатная помощь, если возникнут проблемы интеграции.

Multivendor: Product API

Продавцы могут управлять своими товарами по MPN через простой HTTP API: получать, добавлять, обновлять и удалять товары с помощью ключа API. API работает только с собственными товарами продавца.

Ключ API

  1. Продавец открывает Личный кабинет > Мой аккаунт продавца > Редактировать данные продавца, вкладку «Личные данные».
  2. «Сгенерировать» создаёт «Ключ API» (или заменяет старый).

Администратор видит и может изменить ключ на вкладке «Продавец» покупателя. Запросы с ключом отключённого продавца или отключённого аккаунта покупателя отклоняются. См. «Ключи API».

Vendor profile, Personal tab with the API Key field
Профиль продавца, вкладка «Личные данные» с полем «Ключ API»

Запросы и ответы

Все запросы отправляются на index.php витрины вашего магазина. Ключ передаётся в строке запроса как apikey; данные POST-запросов передаются как поля формы (multipart/form-data, если вы отправляете изображения).

Операция Метод Маршрут
Получить товар GET extension/ka_extensions/ka_multivendor/api/product&apikey=KEY&mpn=MPN
Добавить товар POST extension/ka_extensions/ka_multivendor/api/product/add&apikey=KEY
Обновить товар POST extension/ka_extensions/ka_multivendor/api/product/update&apikey=KEY
Удалить товар POST extension/ka_extensions/ka_multivendor/api/product/delete&apikey=KEY

Полный URL - это https://www.example.com/index.php?route= + маршрут. Используйте HTTPS: ключ является частью URL.

Товары ищутся по полю MPN с точным совпадением среди собственных товаров продавца. Делайте MPN уникальными и всегда передавайте mpn.

Каждый ответ - JSON. success равно true или false; при ошибках message содержит причину. HTTP-статус равен 200 и при ошибках, поэтому проверяйте success.

message Причина
apikey is required В URL нет apikey.
apikey is not correct Ни у одного продавца нет такого ключа.
vendor account is disabled Профиль продавца отключён («Статус продавца»). Отключённый аккаунт покупателя даёт «apikey is not correct».
Invalid request type Для добавления, обновления или удаления использован GET или для получения - POST.
MPN is empty Получение, добавление, обновление или удаление: mpn отсутствует или пуст.
Product was not found Получение или удаление: ни у одного товара этого продавца нет такого MPN.
Product already exists with the specified MPN ... Добавление: этот MPN уже используется данным продавцом.
Product does not exist with the specified MPN Обновление: ни у одного товара этого продавца нет такого MPN.
Missed product_description field Добавление или обновление без product_description.
Category is not allowed for vendors: ID Добавление или обновление: category_id - категория, не открытая для продавцов («Разрешить для продавцов» у категории и её родительских категорий). Категория, которая уже есть у товара, принимается.
The product limit reached Добавление: продавец достиг лимита товаров.

Поля товара

Поле Значение
mpn Ключ товара. Обязательно.
product_description[CODE][name], [description], [tag] Название, описание (HTML) и теги для каждого языка. CODE - код языка, например en-gb. Обязательно при добавлении и обновлении; каждый раз передавайте все языки.
price, special_price Цена и специальная цена для группы покупателей по умолчанию. Пустой или отсутствующий special_price удаляет специальную цену.
quantity, subtract, minimum Остаток, вычитание со склада (1 - остаток учитывается, 0 - без ограничений), минимальное количество.
status 1 - включён, 0 - отключён. Неодобренные товары остаются отключёнными.
category_id Категория товара, одна из категорий, открытых для продавцов. 0 удаляет категорию.
manufacturer_id Производитель.
shipping, weight, weight_class_id, length, width, height, length_class_id Данные доставки, как в форме товара продавца.
product_attributes[LANGUAGE_ID][ATTRIBUTE_ID] Тексты атрибутов. Обратите внимание: здесь ключом является числовой ID языка, а не код. Отсутствие списка удаляет атрибуты товара.
image Основное изображение в виде загружаемого файла.
additional_images[] Дополнительные изображения в виде загружаемых файлов. Они заменяют старые дополнительные изображения; их порядок соответствует порядку загрузки.

При обновлении непереданные поля товара сохраняют свои значения, кроме special_price и product_attributes (см. выше). Изображения и категория сохраняются, если они не переданы.

Получить товар

Команда
curl "https://www.example.com/index.php?route=extension/ka_extensions/ka_multivendor/api/product&apikey=YOUR_API_KEY&mpn=TOMATO-01"

Ответ содержит product с записью товара и его описанием на языке магазина, включая vendor_approval (пусто = черновик, W = ожидает одобрения, A = одобрен).

Добавить товар

Команда
curl -X POST "https://www.example.com/index.php?route=extension/ka_extensions/ka_multivendor/api/product/add&apikey=YOUR_API_KEY" \
  -F "mpn=TOMATO-01" \
  -F "product_description[en-gb][name]=Cherry tomatoes 500 g" \
  -F "product_description[en-gb][description]=

Fresh cherry tomatoes.

" \ -F "price=3.50" -F "quantity=100" -F "subtract=1" -F "minimum=1" \ -F "category_id=25" -F "status=1" \ -F "image=@tomatoes.jpg" \ -F "additional_images[]=@tomatoes-2.jpg"

Товар, добавленный через API, сразу отправляется на одобрение: ответ содержит "approval": "W", и товар остаётся отключённым, пока администратор его не одобрит. Черновиком он не становится. Действует лимит товаров продавца.

Обновить товар

Команда
curl -X POST "https://www.example.com/index.php?route=extension/ka_extensions/ka_multivendor/api/product/update&apikey=YOUR_API_KEY" \
  -F "mpn=TOMATO-01" \
  -F "product_description[en-gb][name]=Cherry tomatoes 500 g" \
  -F "product_description[en-gb][description]=

Fresh cherry tomatoes.

" \ -F "price=3.20" -F "quantity=80"

Обновление работает как «Сохранить» в форме товара продавца (см. «Сохранение и отправка на одобрение»):

  • одобренный товар остаётся одобренным, если меняются только цена, специальная цена, количество, вычитание со склада, минимум, статус, вес, размеры или доставка;
  • другие изменения возвращают его в статус «Ожидает одобрения» и отключают;
  • ожидающий товар остаётся ожидающим, черновик - черновиком.

Ответ содержит approval со статусом после обновления.

Удалить товар

Команда
curl -X POST "https://www.example.com/index.php?route=extension/ka_extensions/ka_multivendor/api/product/delete&apikey=YOUR_API_KEY" \
  -F "mpn=TOMATO-01"

Товар удаляется полностью, вместе со списком изображений, отзывами и SEO URL. Это действие нельзя отменить.

Пример на PHP

PHP
php
$store  = 'https://www.example.com/index.php?route=';
$apikey = 'YOUR_API_KEY';

$ch = curl_init($store . 'extension/ka_extensions/ka_multivendor/api/product/update&apikey=' . urlencode($apikey));
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => [
        'mpn'   => 'TOMATO-01',
        'price' => '3.20',
        'product_description[en-gb][name]'        => 'Cherry tomatoes 500 g',
        'product_description[en-gb][description]' => '

Fresh cherry tomatoes.

'
, ], ]); $result = json_decode(curl_exec($ch), true); curl_close($ch); if (empty($result['success'])) { echo 'Error: ' . ($result['message'] ?? 'no response'); } else { echo 'Saved, approval status: ' . $result['approval']; }

Другие модули могут добавлять в API свои поля; на этой странице описаны поля самого Multivendor.