Cadou cu produs

Documentație API pentru lucrul cu cadouri

Tabel cu descrierile câmpurilor:

Câmp Tip Necesar? Descriere
id int Nu Identificator unic de cadou (necesar la actualizare).
icon (toate limbile)_* sfoară Nu URL la pictograma cadou, localizată pentru fiecare limbă (de exemplu, icon_ro, icon_ru etc.).
image (toate limbile)_* sfoară Nu URL la imaginea cadou, localizată pentru fiecare limbă.
nume (toate limbile)_* sfoară Da Numele cadoului, localizat pentru fiecare limbă (de exemplu, name_ro, name_ru, etc.).
link (toate limbile)_* sfoară Da Informații/link partener localizat pentru fiecare limbă.
descriere (toate limbile)_* sfoară Nu Descrierea cadoului, localizată pentru fiecare limbă.
ora_început datetime Da Data și ora de începere a cadoului.
timp_eliminare datetime Da Data și ora la care expiră cadoul.
activ boolean Da Dacă cadoul este activ (adevărat/fals).

1. Primirea tuturor cadourilor

Metodă: GET
URL: {domeniu}/external/gift/

Descriere:
Returnează o listă cu toate cadourile de pe site.

Exemplu de interogare:

GET {domeniu}/extern/cadou/

Exemplu de răspuns:

[
    {
        „id”: 1,
        "icon_ro": "http://{domain}/media/gift_images/b88e0864-3e94-405c-b23f-5481f009152d.png",
        "icon_ru": nul,
        „icon_en”: nul,
        „icon_uk”: nul,
        "image_ro": "http://{domain}/media/gift_images/52f85402-231b-40ec-b520-a9d5384a3503.png",
        „image_ru”: nul,
        „image_en”: nul,
        „image_uk”: nul,
        "name_ro": "Testul Cadou",
        "name_ru": "Test cadoul",
        "name_en": "Test cadoul",
        "name_uk": "Test cadoul",
        "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": "Test de descriere",
        "description_ru": "Descrierea testului",
        "description_en": "Descrierea testului",
        "description_uk": "Descrierea testului",
        "start_time": "2025-08-25T09:50:00",
        "removal_time": "2025-08-30T10:50:00",
        „activ”: adevărat
    }
]

2. Primiți un cadou

Metodă: GET
URL: {domain}/external/gift/{id}/

Descriere:
Returnează datele pentru un cadou prin identificatorul său unic.

Exemplu de interogare:

GET {domain}/external/gift/1/

Exemplu de răspuns:

{
    „id”: 1,
    "icon_ro": "http://{domain}/media/gift_images/b88e0864-3e94-405c-b23f-5481f009152d.png",
    "icon_ru": nul,
    „icon_en”: nul,
    „icon_uk”: nul,
    "image_ro": "http://{domain}/media/gift_images/52f85402-231b-40ec-b520-a9d5384a3503.png",
    „image_ru”: nul,
    „image_en”: nul,
    „image_uk”: nul,
    "name_ro": "Testul Cadou",
    "name_ru": "Test cadoul",
    "name_en": "Test cadoul",
    "name_uk": "Test cadoul",
    "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": "Test de descriere",
    "description_ru": "Descrierea testului",
    "description_en": "Descrierea testului",
    "description_uk": "Descrierea testului",
    "start_time": "2025-08-25T09:50:00",
    "removal_time": "2025-08-30T10:50:00",
    „activ”: adevărat
}

3. O actualizare cadou

Metodă: PUT
URL: {domain}/external/gift/{id}/

Descriere:
Actualizează datele unui cadou prin identificatorul său unic.

Exemplu de interogare:

PUT {domain}/external/gift/1/
Tip de conținut: application/json

Corpul cererii:

{
    "name_ro": "Cadou actualizat",
    "description_ro": "Descriere actualizată",
    "start_time": "2025-08-26T10:00:00",
    "removal_time": "2025-09-01T18:00:00",
    „activ”: fals
}

Exemplu de răspuns:

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

4. Crearea de cadouri multiple

Metodă: POST
URL: {domeniu}/external/gift/bulk-create/

Descriere:
Creează mai multe cadouri în același timp.

Exemplu de interogare:

POST {domain}/external/gift/bulk-create/
Tip de conținut: application/json

Corpul cererii:

[
    {
        "name_ro": "Cadou nou 1",
        "description_ro": "Descrierea cadou nou 1",
        "start_time": "2025-08-27T10:00:00",
        „removal_time”: „2025-09-02T18:00:00”,
        „activ”: adevărat
    },
    {
        "name_ro": "Cadou nou 2",
        "description_ro": "Descrierea cadou nou 2",
        "start_time": "2025-08-28T09:30:00",
        "removal_time": "2025-09-03T19:00:00",
        „activ”: adevărat
    }
]

Exemplu de răspuns:

[
    {
        „id”: 2,
        "name_ro": "Cadou nou 1",
        "description_ro": "Descrierea cadou nou 1",
        "start_time": "2025-08-27T10:00:00",
        „removal_time”: „2025-09-02T18:00:00”,
        „activ”: adevărat
    },
    {
        „id”: 3,
        "name_ro": "Cadou nou 2",
        "description_ro": "Descrierea cadou nou 2",
        "start_time": "2025-08-28T09:30:00",
        "removal_time": "2025-09-03T19:00:00",
        „activ”: adevărat
    }
]

5. Actualizați mai multe cadouri

Metodă: PUT
URL: {domeniu}/external/gift/bulk-update/

Descriere:
Actualizează datele pentru mai multe cadouri simultan.

Exemplu de interogare:

PUT {domain}/external/gift/bulk-update/
Tip de conținut: application/json

Corpul cererii:

[
    {
        „id”: 1,
        „activ”: fals,
        "start_time": "2025-08-25T11:00:00",
        „removal_time”: „2025-09-01T20:00:00”
    },
    {
        „id”: 2,
        „activ”: adevărat,
        "start_time": "2025-08-28T08:00:00",
        „removal_time”: „2025-09-04T21:00:00”
    }
]

Exemplu de răspuns:

[
    {
        „id”: 1,
        „activ”: fals,
        "start_time": "2025-08-25T11:00:00",
        „removal_time”: „2025-09-01T20:00:00”
    },
    {
        „id”: 2,
        „activ”: adevărat,
        "start_time": "2025-08-28T08:00:00",
        „removal_time”: „2025-09-04T21:00:00”
    }
]

A fost util articolul?

Da, multumesc! Din pacate nu

article.helpfulQuestion

article.original https://docs.ecom.md/548-558-584--podarok-k-tovaru/