API Личного кабинета клиента Stynergy

Базовый URL

Все запросы к методам чтения выполняются по базовому адресу:

https://lk.stynergy.pro/lkapi

Вызов метода осуществляется через параметр task:

https://lk.stynergy.pro/lkapi?task=<МЕТОД>&apikey=<ВАШ_API_КЛЮЧ>

Для передачи заказов используется отдельный URL:

POST https://lk.stynergy.pro/setorders1c

Авторизация

Для доступа ко всем методам API требуется API-ключ, который передаётся в параметре apikey в строке запроса либо в теле запроса (для метода отправки заказов). Значение ключа выдаётся администратором сайта.

{
    "error": "API key is missing."
}
{
    "error": "Invalid API key"
}

Формат запросов и ответов

Методы чтения (GET)

Методы getProducts, getProductsPrice, getContracts, getOrders, getStock вызываются методом GET. Параметры передаются в строке запроса.

Методы записи (POST)

Метод setorders1c предназначен для передачи заказов с вашей 1С-системы и вызывается методом POST. Данные передаются в формате JSON.

Формат данных

• Кодировка: UTF-8
TODO: Уточнить точное значение заголовка Content-Type для POST-запроса (ожидается application/json).
• Ответы: JSON-массив или JSON-объект
• Числа могут возвращаться как строки (например, цена, вес, количество)
• Десятичный разделитель в некоторых полях может быть запятая (например, длина, цена)

Параметры пагинации

Для большинства методов используются базовые параметры пагинации:

Обработка ошибок

В случае ошибок API возвращает JSON-объект с полем error, содержащим текстовое описание проблемы.

{
    "error": "Invalid task"
}

7. Диагностика ошибок

При возникновении ошибок API возвращает JSON-объект с полем error. Примеры возможных ответов:

{
    "error": "Invalid API key"
}
{
    "error": "Invalid task"
}
{
    "error": "API key is missing."
}

Справочник статусов заказов

Ниже приведено соответствие кодов статусов и их текстовых описаний.

Справочник статусов наличия металла

Для получения API-ключа и дополнительной информации об интеграции обратитесь к администратору сайта.

Псевдокод 1С

// Общие параметры подключения
БазовыйURL = "/lkapi";
APIКлюч = "<ВАШ_API_КЛЮЧ>";
HTTP = Новый HTTPСоединение("lk.stynergy.pro", 443, , , , , Истина);

// -------------------------
// 1. Получение договоров
// -------------------------
Путь = СтрШаблон("%1?task=getContracts&apikey=%2", БазовыйURL, APIКлюч);
Ответ = HTTP.Get(Путь);
ДанныеДоговоры = JSONРазобрать(Ответ.ПолучитьТело());

Сообщить("getContracts → найдено договоров: " + Строка(ДанныеДоговоры.Количество()));

ТекущийGUID = ДанныеДоговоры.Ключи()[0];
НомерДоговора = ДанныеДоговоры[ТекущийGUID].Contract;

// -------------------------
// 2. Получение товаров
// -------------------------
Путь = СтрШаблон("%1?task=getProducts&limit=200&apikey=%2", БазовыйURL, APIКлюч);
Ответ = HTTP.Get(Путь);
ДанныеТовары = JSONРазобрать(Ответ.ПолучитьТело());

Сообщить("getProducts → позиций: " + Строка(ДанныеТовары.Количество()));

// -------------------------
// 3. Цены по договору
// -------------------------
Путь = СтрШаблон("%1?task=getProductsPrice&dogovor=%2&limit=100&apikey=%3",
    БазовыйURL, НомерДоговора, APIКлюч);
Ответ = HTTP.Get(Путь);
ДанныеЦены = JSONРазобрать(Ответ.ПолучитьТело());

Сообщить("Цены → первая цена: " + ДанныеЦены[0].price_with_discount);

// -------------------------
// 4. Остатки товара
// -------------------------
ПервыйSKU = ДанныеТовары[0].sku;

Путь = СтрШаблон("%1?task=getStock&sku=%2&apikey=%3",
    БазовыйURL, ПервыйSKU, APIКлюч);
Ответ = HTTP.Get(Путь);
ДанныеОстатки = JSONРазобрать(Ответ.ПолучитьТело());

Сообщить("getStock → " + ДанныеОстатки[0].sku +
    " металл: " + ДанныеОстатки[0].stock_metal);

// -------------------------
// 5. Заказы
// -------------------------
Путь = СтрШаблон("%1?task=getOrders&limit=20&apikey=%2",
    БазовыйURL, APIКлюч);
Ответ = HTTP.Get(Путь);
ДанныеЗаказы = JSONРазобрать(Ответ.ПолучитьТело());

Если ТипЗнч(ДанныеЗаказы) = Тип("Массив") И ДанныеЗаказы.Количество() > 0 Тогда
    Сообщить("getOrders → заказ " + ДанныеЗаказы[0].order_number +
        ", статус: " + ДанныеЗаказы[0].status);
Иначе
    Сообщить("getOrders → заказы отсутствуют");
КонецЕсли;

Псевдокод 1С: отправка заказов (setorders1c)

// ---------------------
// 6. Отправка заказов
// ---------------------
JSONЗаказ =
'{
    "Orders": [
        {
            "order_id": "2303778",
            "id_1c": "2303778",
            "number_order": "ст00-00778",
            "date_order": "05022025-16:25:59",
            "status": "Подтвержден менеджером",
            "number_contract": "' + НомерДоговора + '",
            "idzayavka": "2303778",
            "task": "orders",
            "items": [
                {
                    "order_item_sku": "' + ДанныеТовары[0].sku + '",
                    "product_attribute": "1,500 м.",
                    "product_quantity": 2
                }
            ]
        }
    ]
}';

// HTTPS
HTTP = Новый HTTPСоединение("lk.stynergy.pro", 443, , , , , Истина);

// Формируем POST-запрос
Запрос = Новый HTTPЗапрос("/setorders1c");
Запрос.УстановитьТелоИзСтроки(JSONЗаказ, "UTF-8", "application/json");
Запрос.Заголовки.Вставить("apikey", APIКлюч);

// Выполняем запрос
Ответ = HTTP.Post(Запрос);

// Разбираем результат
СтрокаОтвета = Ответ.ПолучитьТелоКакСтроку();
Попытка
    JSONОтвет = JSONРазобрать(СтрокаОтвета);
Исключение
    Сообщить("Ошибка разбора JSON ответа: " + СтрокаОтвета);
    Возврат;
КонецПопытки;

// Обработка ответа API
Если ТипЗнч(JSONОтвет) = Тип("Структура") Тогда
    Если JSONОтвет.Свойство("error") Тогда
        Сообщить("Ошибка API: " + JSONОтвет.error);
    ИначеЕсли JSONОтвет.Свойство("success") Тогда
        Сообщить("Успешно → " + Строка(JSONОтвет.success));
    Иначе
        Сообщить("Ответ API: " + Строка(JSONОтвет));
    КонецЕсли;
Иначе
    Сообщить("Ответ API (массив): " + Строка(JSONОтвет));
КонецЕсли;