Documentație API pentru lucrul cu magazine (filiale)
Tabel cu descrierile câmpurilor:
| Câmp | Tip | Necesar? | Descriere |
|---|---|---|---|
| id | int | Nu | Identificator unic de magazin. |
| lat | sfoară | Da | Latitudinea geografică a locației magazinului. |
| lon | sfoară | Da | Longitudine geografică a locației magazinului. |
| tooltippintext | sfoară | Nu | Text pentru balonul explicativ al hărții. |
| sfoară | Nu | E-mailul de stocare. | |
| comanda | int | Nu | Numărul de serie al afișajului magazinului. |
| descriere_ro | sfoară | Nu | Descrierea magazinului in romana. |
| descriere_ru | sfoară | Nu | Descrierea magazinului în limba rusă. |
| descriere_ro | sfoară | Nu | Descrierea magazinului în engleză. |
| descriere_uk | sfoară | Nu | Descrierea magazinului în ucraineană. |
| iframe | sfoară | Nu | Un cadru HTML pentru a afișa date suplimentare legate de magazin. |
| companie_id | int | Nu | ID-ul companiei asociate cu magazinul. https://admin.ecom.md/ru/admin/users/company/ |
| este_activ | boolean | Da | Dacă magazinul este activ (adevărat/fals). |
| telefoane | matrice | Nu | O serie de telefoane din magazin cu identificatorii lor (id) și numerele (telefon). https://admin.ecom.md/ru/admin/Base_files/phone/ |
| adrese | obiect | Da | Adresa magazinului. Conține câmpurile: region_id, locality_id, sector_id, address, house, entrance, apartment, zip_code. |
1. Obținerea tuturor magazinelor
Metodă: GET
URL: {domeniu}/external/shop/
Descriere:
Returnează o listă cu toate magazinele (sucursalele) site-ului.
Exemplu de interogare:
GET {domain}/external/shop/
Exemplu de răspuns:
[
{
„id”: 333,
"lat": "47.04425769408643",
"lon": "28.8317133350053",
"tooltip_pin_text": "test de testare",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
"comanda": 55,
"description_ro": null,
"description_ru": nul,
„description_en”: nul,
„description_uk”: nul,
"iframe": "",
„company_id”: nul,
„este_activ”: adevărat,
„telefoane”: [
{
„id”: 4,
„telefon”: „+373 60 11 11 14”
},
{
„id”: 3,
„telefon”: „+373 60 11 11 13”
}
],
„adrese”: {
„region_id”: 3,
„locality_id”: 70,
„sector_id”: 10,
"address": "Vadul lui Voda 78/2",
„casa”: nul,
„intrare”: nul,
„apartament”: nul,
„zip_code”: nul
}
}
]
2. Primiți un magazin
Metodă: GET
URL: {domain}/external/shop/{id}/
Descriere:
Returnează date pentru un magazin prin identificatorul său unic.
Exemplu de interogare:
GET {domain}/external/shop/333/
Exemplu de răspuns:
{
„id”: 333,
"lat": "47.04425769408643",
"lon": "28.8317133350053",
"tooltip_pin_text": "test de testare",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
"comanda": 55,
"description_ro": null,
"description_ru": nul,
„description_en”: nul,
„description_uk”: nul,
"iframe": "",
„company_id”: nul,
„este_activ”: adevărat,
„telefoane”: [
{
„id”: 4,
„telefon”: „+373 60 11 11 14”
},
{
„id”: 3,
„telefon”: „+373 60 11 11 13”
}
],
„adrese”: {
„region_id”: 3,
„locality_id”: 70,
„sector_id”: 10,
"address": "Vadul lui Voda 78/2",
„casa”: nul,
„intrare”: nul,
„apartament”: nul,
„zip_code”: nul
}
}
3. Crearea mai multor magazine
Metodă: POST
URL: {domain}/external/shop/bulk-create/
Descriere:
Creează mai multe magazine în același timp.
Exemplu de interogare:
POST {domain}/external/shop/bulk-create/
Tip de conținut: application/json
Corpul cererii:
[
{
"lat": "47.04425769408643",
"lon": "28.8317133350053", "tooltippintext": "nou magazin de teste", "email": "[email protected]", "comanda": 1, "descriptionro": "Descriere în limba română", "descriptionru": "Descriere în rusă", "descriptionen": "Descriere în engleză", "descriptionuk": "Descrierea ucrainenei", "iframe": "", „companyid”: 1, „esteactiv”: adevărat, „telefoane”: [ { „id”: 1, „telefon”: „+373 60 11 11 11” }, { „id”: 2, „telefon”: „+373 60 11 11 12” } ], „adrese”: { „regionid”: 4, „localityid”: 71, „sectorid”: 11, "address": "Stefan cel Mare 12", "casa": "1", "intrare": "", "apartament": "", "zipcode": "MD-2020" } } ]
Exemplu de răspuns:
[
{
„id”: 334,
"lat": "47.04425769408643",
"lon": "28.8317133350053",
"tooltip_pin_text": "nou magazin de teste",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
"comanda": 1,
"description_ro": "Descriere în limba română",
"description_ru": "Descriere în rusă",
"description_en": "Descriere în engleză",
"description_uk": "Descrierea ucrainenei",
"iframe": "",
„company_id”: 1,
„este_activ”: adevărat,
„telefoane”: [
{
„id”: 1,
„telefon”: „+373 60 11 11 11”
},
{
„id”: 2,
„telefon”: „+373 60 11 11 12”
}
],
„adrese”: {
„region_id”: 4,
„locality_id”: 71,
„sector_id”: 11,
"address": "Stefan cel Mare 12",
"casa": "1",
"intrare": "",
"apartament": "",
"zip_code": "MD-2020"
}
}
]
4. Actualizări multiple ale magazinului
Metodă: PUT
URL: {domeniu}/external/shop/bulk-update/
Descriere:
Actualizează datele din mai multe magazine simultan.
Exemplu de interogare:
PUT {domain}/external/shop/bulk-update/
Tip de conținut: application/json
Corpul cererii:
[
{
„id”: 333,
"tooltip_pin_text": "Sfat informativ pentru magazin actualizat",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
„este_activ”: fals,
„adrese”: {
„region_id”: 3,
„locality_id”: 70,
„sector_id”: 10,
"address": "Adresă actualizată 78/2"
}
},
{
„id”: 334,
"tooltip_pin_text": "o altă actualizare a magazinului",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
„este_activ”: adevărat
}
]
Exemplu de răspuns:
[
{
„id”: 333,
"tooltip_pin_text": "Sfat informativ pentru magazin actualizat",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
„este_activ”: fals,
„adrese”: {
„region_id”: 3,
„locality_id”: 70,
„sector_id”: 10,
"address": "Adresă actualizată 78/2"
}
},
{
„id”: 334,
"tooltip_pin_text": "o altă actualizare a magazinului",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
„este_activ”: adevărat
}
]
A fost util articolul?
Da, multumesc! Din pacate nu