Обзор

API автоматизации продавца Lootly - выполняйте заказы магазина программно.

API автоматизации продавца позволяет внешним системам выполнять заказы магазина без оператора: получать новые заказы по товарам с автоматизацией, брать их в работу, выдавать результат, писать покупателю и завершать или отменять заказ - всё с авторизацией по API-ключу магазина.

Базовый URL - https://api.seller.lootly.dev. Все эндпоинты версионированы под /v1.

Как это работает

Владелец магазина создаёт API-ключ в настройках магазина.
Интеграция вызывает API с этим ключом (Authorization: Bearer <key>).
Ключ привязан ровно к одному магазину - вы видите и меняете только его данные.
Заказы, выполненные через API, помечаются исполнителем api (видно в панели магазина).

Авторизация

Создание ключа и авторизация запросов.

Быстрый старт

Полный цикл выполнения за несколько запросов.

Заказы

Взять, выполнить и отменить заказ.

Чат заказа

Пишите покупателю от имени магазина.

Соглашения

Все запросы и ответы - в формате JSON.
Успешный ответ обёрнут: { "success": true, "data": { … } }.
Ошибки возвращают { "success": false, "error": { "code": "…" } } с соответствующим HTTP-статусом.
Деньги - в рублях (₽); время - строки ISO 8601.

Формат ответа

Успех

{
  "success": true,
  "data": { "order": { "id": "6a2…", "status": "processing" } }
}

Ошибка

{
  "success": false,
  "error": { "code": "ORDER_INVALID_STATUS" }
}

API ограничен рамками магазина. Ключ не может читать или менять заказы, товары или чаты другого магазина.