Stoc

Documentație API pentru lucrul cu acțiuni

Tabel cu descrierile câmpurilor:

Câmp Tip Necesar? Descriere
id int Nu Identificator unic de promovare (necesar la actualizare).
nume_ro sfoară Da Denumirea actiunii este in limba romana.
nume_ru sfoară Da Numele acțiunii este în rusă.
nume_ro sfoară Nu Numele acțiunii în engleză.
nume_uk sfoară Nu Numele acțiunii este în ucraineană.
ascunde boolean Da Indică dacă promovarea este ascunsă (adevărat/fals).
informații sfoară Nu Informații suplimentare despre promoție.
data_expirarii datetime Da Data și ora la care se încheie promoția.
poziție int Nu Poziția stocului în lista generală.
prioritate int Nu Prioritatea acțiunii.
melc sfoară Da Identificatorul unic al cotei (servitori).
showinpromo_block boolean Nu Indică dacă promovarea este afișată în blocul de promovare (adevărat/fals).
showisslider boolean Nu Indică dacă stocul este afișat ca glisor (adevărat/fals).
show_on sfoară Nu Setări de afișare a promoției (de exemplu: "start").

1. Primiți toate acțiunile

Metodă: GET
URL: {domeniu}/extern/promo/

Descriere:
Returnează o listă cu toate promoțiile de pe site.

Exemplu de interogare:

GET {domain}/external/promo/

Exemplu de răspuns:

[
    {
        „id”: 26,
        "name_ro": "Toamna ta - reducerile noastre! Boxenew",
        "name_ru": "Reduceri bune de toamnă! Boxe5",
        "name_en": "Numele promoției",
        "name_uk": "Numele promoției",
        „ascunde”: fals,
        „informații”: nul,
        „expire_date”: „2024-03-04T08:15:00”,
        „poziție”: 10,
        „prioritate”: 0,
        "slug": "toamna-ta-reducerile-noastre-boxenew",
        „show_in_promo_block”: fals,
        „show_is_slider”: fals,
        „show_on”: nul
    },
    {
        „id”: 25,
        "name_ro": "smartpromonew",
        "name_ru": "smartpromoru5",
        "name_en": "Nume promoționalEN",
        "name_uk": "Numele promoției",
        „ascunde”: fals,
        „informații”: nul,
        „expire_date”: „2025-02-28T17:30:00”,
        „poziție”: 1,
        „prioritate”: 10,
        "slug": "smartpromonew",
        „show_in_promo_block”: fals,
        „show_is_slider”: fals,
        "show_on": "începe"
    }
]

2. Primiți o distribuire

Metodă: GET
URL: {domain}/external/promo/{promo_id}/

Descriere:
Returnează date pentru un stoc prin identificatorul său unic.

Exemplu de interogare:

GET {domain}/external/promo/26/

Exemplu de răspuns:

{
    „id”: 26,
    "name_ro": "Toamna ta - reducerile noastre! Boxenew",
    "name_ru": "Reduceri bune de toamnă! Boxe5",
    "name_en": "Numele promoției",
    "name_uk": "Numele promoției",
    „ascunde”: fals,
    „informații”: nul,
    „expire_date”: „2024-03-04T08:15:00”,
    „poziție”: 10,
    „prioritate”: 0,
    "slug": "toamna-ta-reducerile-noastre-boxenew",
    „show_in_promo_block”: fals,
    „show_is_slider”: fals,
    „show_on”: nul
}

3. Actualizați o promoție

Metodă: PUT
URL: {domain}/external/promo/{promo_id}/

Descriere:
Actualizează datele pentru un stoc prin identificatorul său unic.

Exemplu de interogare:

PUT {domain}/external/promo/26/
Tip de conținut: application/json

Corpul cererii:

{
    "name_ro": "Toamna ta - reducerile noastre! UPDATED",
    "name_ru": "Reduceri bune de toamnă! ACTUALIZAT",
    „expire_date”: „2025-01-01T12:00:00”,
    „poziție”: 5,
    „prioritate”: 1,
    „ascunde”: fals,
    „show_in_promo_block”: adevărat,
    „show_is_slider”: adevărat
}

Exemplu de răspuns:

{
    „id”: 26,
    "name_ro": "Toamna ta - reducerile noastre! UPDATED",
    "name_ru": "Reduceri bune de toamnă! ACTUALIZAT",
    "name_en": "Numele promoției",
    "name_uk": "Numele promoției",
    „ascunde”: fals,
    „informații”: nul,
    „expire_date”: „2025-01-01T12:00:00”,
    „poziție”: 5,
    „prioritate”: 1,
    "slug": "toamna-ta-reducerile-noastre-boxenew",
    „show_in_promo_block”: adevărat,
    „show_is_slider”: adevărat,
    „show_on”: nul
}

4. Crearea de acțiuni multiple

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

Descriere:
Creează mai multe acțiuni în același timp.

Exemplu de interogare:

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

Corpul cererii:

[
    {
        "name_ro": "Toamna nouă! Boxenew",
        "name_ru": "Toamnă nouă! Boxe5",
        "name_en": "Numele promoției nou",
        "name_uk": "Nume promoție nou",
        „ascunde”: fals,
        "info": "Informații promoționale noi",
        „expire_date”: „2024-06-01T09:00:00”,
        „poziție”: 2,
        „prioritate”: 5,
        "slug": "toamna-noua-boxenew",
        „show_in_promo_block”: adevărat,
        „show_is_slider”: fals,
        "show_on": "începe"
    },
    {
        "name_ro": "Promo Boxenew 2",
        "name_ru": "Promo Boxe5 2",
        "name_en": "Numele promoției 2",
        "name_uk": "Numele promoției 2",
        „ascunde”: fals,
        "info": "Descrierea promoției 2",
        „expire_date”: „2023-12-01T09:00:00”,
        „poziție”: 1,
        „prioritate”: 10,
        "slug": "promo-boxenew-2",
        „show_in_promo_block”: fals,
        „show_is_slider”: adevărat,
        "show_on": "sfârșit"
    }
]

Exemplu de răspuns:

[
    {
        „id”: 27,
        "name_ro": "Toamna nouă! Boxenew",
        "name_ru": "Toamnă nouă! Boxe5",
        "name_en": "Numele promoției nou",
        "name_uk": "Nume promoție nou",
        „ascunde”: fals,
        "info": "Informații promoționale noi",
        „expire_date”: „2024-06-01T09:00:00”,
        „poziție”: 2,
        „prioritate”: 5,
        "slug": "toamna-noua-boxenew",
        „show_in_promo_block”: adevărat,
        „show_is_slider”: fals,
        "show_on": "începe"
    },
    {
        „id”: 28,
        "name_ro": "Promo Boxenew 2",
        "name_ru": "Promo Boxe5 2",
        "name_en": "Numele promoției 2",
        "name_uk": "Numele promoției 2",
        „ascunde”: fals,
        "info": "Descrierea promoției 2",
        „expire_date”: „2023-12-01T09:00:00”,
        „poziție”: 1,
        „prioritate”: 10,
        "slug": "promo-boxenew-2",
        „show_in_promo_block”: fals,
        „show_is_slider”: adevărat,
        "show_on": "sfârșit"
    }
]

5. Actualizare cu mai multe promoții

Metodă: POST
URL: {domeniu}/external/promo/bulk-update/

Descriere:
Actualizează datele pentru mai multe stocuri în același timp.

Exemplu de interogare:

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

Corpul cererii:

[
    {
        „id”: 25,
        "name_ro": "Promoție actualizată",
        "name_ru": "Promoția actualizată",
        „expire_date”: „2025-03-01T10:00:00”
    },
    {
        „id”: 26,
        "name_ro": "Actualizare Toamna",
        „prioritate”: 99
    }
]

Exemplu de răspuns:

[
    {
        „id”: 25,
        "name_ro": "Promoție actualizată",
        "name_ru": "Promoția actualizată",
        "name_en": "Nume promoționalEN",
        "name_uk": "Numele promoției",
        „ascunde”: fals,
        „informații”: nul,
        „expire_date”: „2025-03-01T10:00:00”,
        „poziție”: 1,
        „prioritate”: 10,
        "slug": "smartpromonew",
        „show_in_promo_block”: fals,
        „show_is_slider”: fals,
        "show_on": "începe"
    },
    {
        „id”: 26,
        "name_ro": "Actualizare Toamna",
        "name_ru": "Reduceri bune de toamnă! Boxe5",
        "name_en": "Numele promoției",
        "name_uk": "Numele promoției",
        „ascunde”: fals,
        „informații”: nul,
        „expire_date”: „2024-03-04T08:15:00”,
        „poziție”: 10,
        „prioritate”: 99,
        "slug": "toamna-ta-reducerile-noastre-boxenew",
        „show_in_promo_block”: fals,
        „show_is_slider”: fals,
        „show_on”: nul
    }
]

A fost util articolul?

Da, multumesc! Din pacate nu

article.helpfulQuestion

article.original https://docs.ecom.md/548-558-575--akcii/