Главная
/
Товары источников

Apicore Dealer API

Начало работы

  • Для запросов в API используется метод POST
  • Для подключения нужен Api-ключ (Получить <Api-ключ> можно в разделе кабинета "Настройки")
  • Тело запроса raw должно быть в формате JSON
  • Ответ отдается также в формате JSON

Интерфейс API: https://api.apicore.one

Заголовки запроса (Headers)

POST / HTTP 1.1
Host: https://api.apicore.one
Api-Key: <Api-ключ>
Content-Type: application/json
Accept: application/json
Внимание!

Не передавайте Api-ключ посторонним лицам!

На запросы по API действует правило - не более 2-х запросов в секунду.

Если от вас поступает слишком много ошибочных или одинаковых запросов, мы можем ограничить доступ к API

Если вам требуется дополнительная функциональность в API, пишите на support@apicore.one, с радостью рассмотрим предложения.

Telegram

Kанал по актуальным обновлениям.

Скачать спецификацию OpenAPI
dealer.json
dealer.yaml
Обзор API
Связаться с поддержкой support@apicore.one
Языки программирования
Серверы
Основной сервер
https://api.apicore.one/

Api-ключ

Операции

Категории каталогов Дистрибьюторов

Операции

Товары Дистрибьюторов

Операции

Работа с каталогами Дилера

Операции

Категории каталогов

Операции

Товары каталогов

Операции

Работа с источниками дилера

Операции

Категории источников

Операции

Товары источников

Операции

Импорт карточки товара

Запрос

Метод полностью обновляет товары источника дилера. Данные по товарам ставятся в общую очередь на обновление товаров.

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

Запрос ограничен 100 товарами, если больше, то возвращается ошибка.

Возвращает статус добавления данных в очередь на обработку, результат обработки которого можно проверить методом import.status.

Заголовки
Content-TypestringОбязательные поля
Пример: application/json
AcceptstringОбязательные поля
Пример: application/json
Api-KeystringОбязательные поля
Телоapplication/json
source_codestringОбязательные поля

Код источника дилера.

productsArray of objects

Массив товаров

curl -i -X POST \
  https://api.apicore.one/dealer/v1/product.import \
  -H 'Accept: application/json' \
  -H 'Api-Key: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_code": "1c",
    "products": [
      {
        "id": "product-1",
        "name": "Название товара",
        "long_name": "Длинное название Товара с перечислением некоторых особенностей",
        "category_id": "category-2",
        "purchase": 150990,
        "retail": 161500,
        "currency": "KZT",
        "quantity": 0,
        "order": true,
        "barcode": "1234567890123",
        "vendor": "Бренд",
        "vendor_code": "Артикул",
        "inner_code": "123456",
        "quality": "new",
        "description": "Описание товара",
        "images": [
          "https://domain/img/21ontk0ezjqz6yephhymwd16j2mobu5r.png",
          "https://domain/img/33ox4msgbwepcs2r3y3dpur77dhpi76o.jpg"
        ],
        "images_base64": [
          "iVBORw0KGgoAAAANSUhEUgAABeMAAANUCAIAAAC/nKEJAAAACXBIWXMAA...",
          "iNQAAAAAAAJ6CSA0AAAAAAICnIFIDAAAAAADgKYjUAAAAAAAAeAoiNQAA..."
        ],
        "props": [
          {
            "name": "Название свойства товара 1",
            "value": "Значение свойства товара 1"
          },
          {
            "name": "Название свойства товара 2",
            "value": "Значение свойства товара 2"
          }
        ],
        "params": {
          "width": 170,
          "height": 230,
          "length": 10,
          "dimensions_unit": "mm",
          "weight": 150,
          "weight_unit": "g"
        }
      }
    ]
  }'

Ответы

Успешный ответ

Телоapplication/json
statusboolean
messagestring
stack_idnumber
Ответ
application/json
{
  "status": true,
  "message": "Создана очередь на обновление товаров",
  "stack_id": 1
}

Обновление цен товаров

Запрос

Метод обновляет цены товаров.

Запрос ограничен 1000 товарами, если больше, то возвращается ошибка.

Возвращает статус добавления данных в очередь на обработку, результат обработки которого можно проверить методом import.status.

Заголовки
Content-TypestringОбязательные поля
Пример: application/json
AcceptstringОбязательные поля
Пример: application/json
Api-KeystringОбязательные поля
Телоapplication/json
source_codestringОбязательные поля

Код источника дилера.

productsArray of objects

Массив остатков товаров

curl -i -X POST \
  https://api.apicore.one/dealer/v1/product.price.import \
  -H 'Accept: application/json' \
  -H 'Api-Key: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_code": "1c",
    "products": [
      {
        "id": "product-1",
        "purchase": 151990,
        "retail": 170500,
        "currency": "KZT"
      }
    ]
  }'

Ответы

Успешный ответ

Телоapplication/json
statusboolean
messagestring
stack_idnumber
Ответ
application/json
{
  "status": true,
  "message": "Создана очередь на обновление товаров",
  "stack_id": 1
}

Обновление остатков товаров

Запрос

Метод обновляет остатки товаров.

Запрос ограничен 1000 товарами, если больше, то возвращается ошибка.

Возвращает статус добавления данных в очередь на обработку, результат обработки которого можно проверить методом import.status.

Заголовки
Content-TypestringОбязательные поля
Пример: application/json
AcceptstringОбязательные поля
Пример: application/json
Api-KeystringОбязательные поля
Телоapplication/json
source_codestringОбязательные поля

Код источника дилера.

productsArray of objects

Массив остатков товаров

curl -i -X POST \
  https://api.apicore.one/dealer/v1/product.quantity.import \
  -H 'Accept: application/json' \
  -H 'Api-Key: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_code": "1c",
    "products": [
      {
        "id": "product-1",
        "quantity": 3
      }
    ]
  }'

Ответы

Успешный ответ

Телоapplication/json
statusboolean
messagestring
stack_idnumber
Ответ
application/json
{
  "status": true,
  "message": "Создана очередь на обновление товаров",
  "stack_id": 1
}

Получение списка кодов "Качества товара"

Запрос

Метод возвращает список значений и кодов "Качества товара".

Заголовки
Content-TypestringОбязательные поля
Пример: application/json
AcceptstringОбязательные поля
Пример: application/json
Api-KeystringОбязательные поля
curl -i -X POST \
  https://api.apicore.one/dealer/v1/product.quality.list \
  -H 'Accept: application/json' \
  -H 'Api-Key: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json'

Ответы

Успешный ответ

Телоapplication/json
statusboolean
qualityArray of objects

Массив кодов и значений "Качества товара"

countnumber

Количество элементов "Качества"

Ответ
application/json
{
  "status": true,
  "quality": [
    { … },
    { … },
    { … },
    { … }
  ],
  "count": 4
}

Работа со стеком импорта

Операции
PC "APICORE LTD" ©