Подарок к товару

Документация API для работы с подарками

Таблица с описанием полей:

Поле Тип Обязательное? Описание
id int Нет Уникальный идентификатор подарка (обязателен при обновлении).
icon (все языки)_* string Нет URL на иконку подарка, локализованный для каждого языка (например, icon_ro, icon_ru и т. д.).
image (все языки)_* string Нет URL на изображение подарка, локализованное для каждого языка.
name (все языки)_* string Да Название подарка, локализованное для каждого языка (например, name_ro, name_ru и т. д.).
link (все языки)_* string Да Ссылка на информацию/партнера, локализованная для каждого языка.
description (все языки)_* string Нет Описание подарка, локализованное для каждого языка.
start_time datetime Да Дата и время начала действия подарка.
removal_time datetime Да Дата и время завершения действия подарка.
active boolean Да Активен ли подарок (true/false).

1. Получение всех подарков

Метод: GET
URL: {domain}/external/gift/

Описание:
Возвращает список всех подарков сайта.

Пример запроса:

GET {domain}/external/gift/

Пример ответа:

[
    {
        "id": 1,
        "icon_ro": "http://{domain}/media/gift_images/b88e0864-3e94-405c-b23f-5481f009152d.png",
        "icon_ru": null,
        "icon_en": null,
        "icon_uk": null,
        "image_ro": "http://{domain}/media/gift_images/52f85402-231b-40ec-b520-a9d5384a3503.png",
        "image_ru": null,
        "image_en": null,
        "image_uk": null,
        "name_ro": "Cadou test",
        "name_ru": "Тестовый подарок",
        "name_en": "Test gift",
        "name_uk": "Тестовий подарунок",
        "link_ro": "https://www.google.com/",
        "link_ru": "https://www.google.com/",
        "link_en": "https://www.google.com/",
        "link_uk": "https://www.google.com/",
        "description_ro": "Descriere test",
        "description_ru": "Тестовое описание",
        "description_en": "Test description",
        "description_uk": "Тестовий опис",
        "start_time": "2025-08-25T09:50:00",
        "removal_time": "2025-08-30T10:50:00",
        "active": true
    }
]

2. Получение одного подарка

Метод: GET
URL: {domain}/external/gift/{id}/

Описание:
Возвращает данные одного подарка по его уникальному идентификатору.

Пример запроса:

GET {domain}/external/gift/1/

Пример ответа:

{
    "id": 1,
    "icon_ro": "http://{domain}/media/gift_images/b88e0864-3e94-405c-b23f-5481f009152d.png",
    "icon_ru": null,
    "icon_en": null,
    "icon_uk": null,
    "image_ro": "http://{domain}/media/gift_images/52f85402-231b-40ec-b520-a9d5384a3503.png",
    "image_ru": null,
    "image_en": null,
    "image_uk": null,
    "name_ro": "Cadou test",
    "name_ru": "Тестовый подарок",
    "name_en": "Test gift",
    "name_uk": "Тестовий подарунок",
    "link_ro": "https://www.google.com/",
    "link_ru": "https://www.google.com/",
    "link_en": "https://www.google.com/",
    "link_uk": "https://www.google.com/",
    "description_ro": "Descriere test",
    "description_ru": "Тестовое описание",
    "description_en": "Test description",
    "description_uk": "Тестовий опис",
    "start_time": "2025-08-25T09:50:00",
    "removal_time": "2025-08-30T10:50:00",
    "active": true
}

3. Обновление одного подарка

Метод: PUT
URL: {domain}/external/gift/{id}/

Описание:
Обновляет данные одного подарка по его уникальному идентификатору.

Пример запроса:

PUT {domain}/external/gift/1/
Content-Type: application/json

Тело запроса:

{
    "name_ro": "Cadou actualizat",
    "description_ro": "Descriere actualizată",
    "start_time": "2025-08-26T10:00:00",
    "removal_time": "2025-09-01T18:00:00",
    "active": false
}

Пример ответа:

{
    "id": 1,
    "name_ro": "Cadou actualizat",
    "description_ro": "Descriere actualizată",
    "start_time": "2025-08-26T10:00:00",
    "removal_time": "2025-09-01T18:00:00",
    "active": false
}

4. Создание нескольких подарков

Метод: POST
URL: {domain}/external/gift/bulk-create/

Описание:
Создаёт несколько подарков одновременно.

Пример запроса:

POST {domain}/external/gift/bulk-create/
Content-Type: application/json

Тело запроса:

[
    {
        "name_ro": "Cadou nou 1",
        "description_ro": "Descriere cadou nou 1",
        "start_time": "2025-08-27T10:00:00",
        "removal_time": "2025-09-02T18:00:00",
        "active": true
    },
    {
        "name_ro": "Cadou nou 2",
        "description_ro": "Descriere cadou nou 2",
        "start_time": "2025-08-28T09:30:00",
        "removal_time": "2025-09-03T19:00:00",
        "active": true
    }
]

Пример ответа:

[
    {
        "id": 2,
        "name_ro": "Cadou nou 1",
        "description_ro": "Descriere cadou nou 1",
        "start_time": "2025-08-27T10:00:00",
        "removal_time": "2025-09-02T18:00:00",
        "active": true
    },
    {
        "id": 3,
        "name_ro": "Cadou nou 2",
        "description_ro": "Descriere cadou nou 2",
        "start_time": "2025-08-28T09:30:00",
        "removal_time": "2025-09-03T19:00:00",
        "active": true
    }
]

5. Обновление нескольких подарков

Метод: PUT
URL: {domain}/external/gift/bulk-update/

Описание:
Обновляет данные нескольких подарков одновременно.

Пример запроса:

PUT {domain}/external/gift/bulk-update/
Content-Type: application/json

Тело запроса:

[
    {
        "id": 1,
        "active": false,
        "start_time": "2025-08-25T11:00:00",
        "removal_time": "2025-09-01T20:00:00"
    },
    {
        "id": 2,
        "active": true,
        "start_time": "2025-08-28T08:00:00",
        "removal_time": "2025-09-04T21:00:00"
    }
]

Пример ответа:

[
    {
        "id": 1,
        "active": false,
        "start_time": "2025-08-25T11:00:00",
        "removal_time": "2025-09-01T20:00:00"
    },
    {
        "id": 2,
        "active": true,
        "start_time": "2025-08-28T08:00:00",
        "removal_time": "2025-09-04T21:00:00"
    }
]

Была ли статья полезна?

Да, спасибо! К сожалению, нет

Была ли эта статья полезной?

Оригинал: https://docs.ecom.md/548-558-584--podarok-k-tovaru/