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
ideste necesar pentru a actualiza caracteristicile. - Pentru a crea o caracteristică, câmpul
ideste 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_keypoate fi omis și sistemul le va genera automat.
A fost util articolul?
Da, multumesc! Din pacate nu