Caracteristici


Documentație API pentru lucrul cu caracteristici

Tabel cu descrierile câmpurilor:

Câmp Tip Necesar? Descriere
id int Nu Identificatorul unic al caracteristicii (necesar la actualizare).
sp_key șir Nu (generat automat) O cheie caracteristică unică (de exemplu: „putere difuzorului din spate”).
nume_ro șir Da Numele caracteristicii este in limba romana.
nume_ru șir Da Numele caracteristicii este în rusă.
nume_ro șir Nu Numele caracteristicii în engleză (dacă este necesar).
nume_uk șir Nu Numele caracteristicii în ucraineană (dacă este necesar).

1. Obținerea tuturor caracteristicilor

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

Descriere:
Returnează o listă cu toate caracteristicile site-ului.

Exemplu de interogare:

GET {domeniu}/extern/specificație/

Exemplu de răspuns:

[
    {
        „id”: 97,
        "sp_key": "putere difuzor spate",
        "name_ro": "Puterea difuzoarelor din spate",
        "name_ru": "Puterea difuzoarelor din spate",
        „name_en”: nul,
        „name_uk”: nul
    },
    {
        „id”: 22,
        "sp_key": "timp de încărcare",
        "name_ro": "TIMP DE ÎNCĂRCARE",
        "name_ru": "TIMP DE ÎNCĂRCARE",
        „name_en”: nul,
        „name_uk”: nul
    }
]

2. Obținerea unei caracteristici

Metodă: GET
URL: {domeniu}/extern/specificație/{id}/

Descriere:
Returnează date pentru o caracteristică.

Exemplu de interogare:

GET {domain}/external/specification/97/

Exemplu de răspuns:

{
    „id”: 97,
    "sp_key": "putere difuzor spate",
    "name_ro": "Puterea difuzoarelor din spate",
    "name_ru": "Puterea difuzoarelor din spate",
    „name_en”: nul,
    „name_uk”: nul
}

3. Actualizați o caracteristică

Metodă: PUT
URL: {domeniu}/extern/specificație/{id}/

Descriere:
Actualizează informații despre o caracteristică.

Exemplu de interogare:

PUT {domain}/external/specification/97/
Tip de conținut: application/json

Corpul cererii:

{
    "sp_key": "putere_difuzor_spate",
    "name_ro": "Puterea difuzoarelor spate",
    "name_ru": "Puterea difuzoarelor din spate a fost actualizată",
    "name_en": "Puterea difuzorului din spate",
    "name_uk": "Etanșeitatea coloanelor de apă"
}

Exemplu de răspuns:

{
    „id”: 97,
    "sp_key": "putere_difuzor_spate",
    "name_ro": "Puterea difuzoarelor spate",
    "name_ru": "Puterea difuzoarelor din spate a fost actualizată",
    "name_en": "Puterea difuzorului din spate",
    "name_uk": "Etanșeitatea coloanelor de apă"
}

4. Crearea de caracteristici multiple

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

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

Exemplu de interogare:

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

Corpul cererii:

[
    {
        "sp_key": "new_characteristic_1",
        "name_ro": "Caracteristică nouă 1",
        "name_ru": "Caracteristica nouă 1",
        "name_en": "Specificație nouă 1",
        "name_uk": "Funcție nouă 1"
    },
    {
        "sp_key": "new_characteristic_2",
        "name_ro": "Caracteristică nouă 2",
        "name_ru": "Noua caracteristică 2",
        "name_en": "Specificație nouă 2",
        "name_uk": "Funcția nouă 2"
    }
]

Exemplu de răspuns:

[
    {
        „id”: 101,
        "sp_key": "new_characteristic_1",
        "name_ro": "Caracteristică nouă 1",
        "name_ru": "Caracteristica nouă 1",
        "name_en": "Specificație nouă 1",
        "name_uk": "Funcție nouă 1"
    },
    {
        „id”: 102,
        "sp_key": "new_characteristic_2",
        "name_ro": "Caracteristică nouă 2",
        "name_ru": "Noua caracteristică 2",
        "name_en": "Specificație nouă 2",
        "name_uk": "Funcția nouă 2"
    }
]

5. Actualizări multiple ale caracteristicilor

Metodă: PUT
URL: {domeniu}/external/specification/bulk-update/ Descriere:
Actualizează mai multe caracteristici în același timp.

Exemplu de interogare:

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

Corpul cererii:

[
    {
        „id”: 97,
        "sp_key": "puterea difuzorului spate actualizată",
        "name_ro": "Puterea difuzoarelor spate actualizate",
        "name_ru": "Puterea difuzoarelor din spate a fost actualizată",
        "name_en": "Puterea difuzorului spate actualizată",
        "name_uk": "Etanșeitatea coloanelor de apă a fost actualizată"
    },
    {
        „id”: 22,
        "sp_key": "timp_încărcare_actualizat",
        "name_ro": "TIMP DE ÎNCĂRCARE ACTUALIZAT",
        "name_ru": "Timpul de încărcare a fost actualizat",
        "name_en": "TIMP DE ÎNCĂRCARE UPDATE",
        "name_uk": "ORA DE ÎNCĂRCARE ACTUALIZATĂ"
    }
]

Exemplu de răspuns:

[
    {
        „id”: 97,
        "sp_key": "puterea difuzorului spate actualizată",
        "name_ro": "Puterea difuzoarelor spate actualizate",
        "name_ru": "Puterea difuzoarelor din spate a fost actualizată",
        "name_en": "Puterea difuzorului spate actualizată",
        "name_uk": "Etanșeitatea coloanelor de apă a fost actualizată"
    },
    {
        „id”: 22,
        "sp_key": "timp_încărcare_actualizat",
        "name_ro": "TIMP DE ÎNCĂRCARE ACTUALIZAT",
        "name_ru": "Timpul de încărcare a fost actualizat",
        "name_en": "TIMP DE ÎNCĂRCARE UPDATE",
        "name_uk": "ORA DE ÎNCĂRCARE ACTUALIZATĂ"
    }
]

Note:

  • Câmpul id este necesar pentru a actualiza caracteristicile.
  • Pentru a crea o caracteristică, câmpul id este omis.
  • Câmpurile cu numele caracteristicii (nume_*) pot fi completate numai pentru acele limbi care sunt necesare pe sistemul dumneavoastră. Sunt permise valori goale.
  • Câmpul sp_key poate fi omis și sistemul le va genera automat.

A fost util articolul?

Da, multumesc! Din pacate nu

article.helpfulQuestion