- Obțineți token-ul site-ului de la manager:
[POST] - {domain}/external/category/
*
{domain}=admin.ecom.md*
- Adăugați token-ul la antet
Toate câmpurile returnate sunt disponibile și pentru actualizare
Categories :
[GET] - {domain}/external/category/ - obțineți toate categoryiile site-ului
{
"id": 2964, #(INT) ID on baza noastră de date
"position": 10, #INT - poziția categoriei pe site în meniu
"name_ro": "Telefoane",
"name_ru": "Phones",
"name_en": null,
"name_uk": null,
"slug_ro": "telefoane-1",
"slug_ru": "telefony",
"slug_en": "telefoane-1",
"slug_uk": "telefoane-1",
"hide": false, #Deschisă/Închisă
"description_ro": null,
"description_ru": null,
"description_en": null,
"description_uk": null,
"description_position": null,
"group_category_id": "testing-phone-cat-id", #(STR) Orice identifier convenabil pentru tine (ID din baza ta de date, cod, etc. )
"meta_description_ro": null,
"meta_description_ru": null,
"meta_description_en": null,
"meta_description_uk": null,
"meta_title_ro": null,
"meta_title_en": null,
"meta_title_en": null,
"meta_title_uk": null,
"meta_keywords_ro": null,
"meta_keywords_ru": null,
"meta_keywords_en": null,
"meta_keywords_uk": null,
"show_18_popup": true,
"category_id": null - ID category category (int)
}
[GET] - {domain}/external/category/{id} - obține o categorie
*[PUT] - {domain}/external/category/{id}/ - *actualizează 1 category
*[POST] - {domain}/external/category/bulk-create/ - *creează mai multe categorii
*[PUT] - {domain}/external/category/bulk-update/ - *actualizează mai multe categorii**
{
"id": 27,
"position": 9,
"name_ro": "Acustica de casa Hi-Fi",
"name_ru": "Home Hi-Fi speakers",
"name_en": "",
"name_uk": "",
"slug_ro": "acustica-de-casa",
"slug_ru": "acustica-de-casa",
"slug_en": "acustica-de-casa",
"slug_uk": null,
"hide": false,
...
}
[PUT] - {domain}/external/category/{id}/bulk-update/
[
{
"id": 27,
"position": 9,
"name_ro": "Acustica de casa Hi-Fi",
"name_ru": "Home Hi-Fi speakers",
"name_en": "",
"name_uk": "",
"slug_ro": "acustica-de-casa",
"slug_ru": "acustica-de-casa",
"slug_en": "acustica-de-casa",
"slug_uk": null,
"hide": false,
...
},
{
"id": 28,
"position": 9,
"name_ro": "Acustica de casa Hi-Fi",
"name_ru": "Home Hi-Fi speakers",
"name_en": "",
"name_uk": "",
"slug_ro": "acustica-de-casa",
"slug_ru": "acustica-de-casa",
"slug_en": "acustica-de-casa",
"slug_uk": null,
"hide": false,
...
}
]
5. Crearea/actualizarea unei caracteristici:
[GET] - {domain}/external/specification/ - obține toate caracteristicile site-ului
*[GET] - {domain}/external/specification/{id} - *obține o caracteristică
*[PUT] - {domain}/external/specification/{id}/ - *actualizează o caracteristică
*[POST] - {domain}/external/specification/bulk-create/ - *creează mai multe caracteristici
*[PUT] - {domain}/external/specification/bulk-update/ - *actualizează mai multe caracteristici
6.Crearea/actualizarea valorilor caracteristicilor:**
[GET] - {domain}/external/specification-value/ - obține toate valorile caracteristicilor site-ului
[GET] - {domen}/external/specification-value/{id} - obține o valoare a unei caracteristici
[PUT] - {domain}/external/specification-value/{id}/ - actualizează o valoarea unei caracteristici*
[POST] - {domen}/external/specification-value/bulk-create/ - *creează mai multe valori pentru caracteristici
[PUT] - {domen}/external/specification-value/bulk-update/ - actualizează mai multe valoripentru caracteristici**
7.Produse** :
[GET] - {domain}/external/product/ - obține toate produsele site-ului
[GET] - {domain}/external/product/{id} - obține un produs
[POST] - {domain}/external/product/bulk-create/ - creează mai multe produse
În obiect obligatoriu transmite groupproductid sau ID din baza noastră de date.
Exemplu payload:
[
{
"bookmark": true,
"price": "1399.00",
"qty": 9,
"sort_priority": 0,
"old_price": "1099.00",
"group_product_id": "new_product_testt",
"weight": null, "height": null, "width": null, "length": null, "brandid": null, "keywords": "", "specifications": [ { "id": 1540, "specificationid": 22, "specificationvalueid": 181 }, { "id": 1541, "specificationid": 38, "specificationvalueid": 225 }, { "id": 1542, "specificationid": 28, "specificationvalueid": 175 }, { "id": 1543, "specificationid": 74, "specificationvalueid": 224 }, { "id": 1544, "specificationid": 87, "specificationvalueid": 671 }, { "id": 1545, "specificationid": 15, "specificationvalueid": 226 }, { "id": 1546, "specificationid": 76, "specificationvalueid": 214 } ], "namero": "JBL Tune 720 BT White", "nameru": "JBL Tune 720 BT White", "nameen": "", "nameuk": null, "slugro": "jbl-jbl-tune-720-bt-white1", "slugru": "jbl-jbl-tune-720-bt-white1", "slugen": "jbl-jbl-tune-720-bt-white1", "sluguk": null, "shortdescriptionro": null, "shortdescriptionru": null, "shortdescriptionen": null, "shortdescriptionuk": null, "descriptionro": "test test", "descriptionen": "test test", "descriptionen": null, "descriptionuk": null, "unitmeasurementro": null, "unitmeasurementru": null, "unitmeasurementen": null, "unitmeasurementuk": null, "seotitlero": null, "seotitleru": null, "seotitleen": null, "seotitleuk": null, "seodescriptionro": null, "seodescriptionru": null, "seodescriptionen": null, "seodescriptionuk": null, "seokeywordsro": null, "seokeywordsru": null, "seokeywordsen": null, "seokeywordsuk": null, "code": "qwer12344", "category": [ 1020 ], "images": [ { "order": 1, "originalname": "2e0b4c7e383f463687a9e66fb3dc66a2.jpg" }, { "order": 2, "originalname": "6d44a748-d164-11ee-ae36-0025905ed821.jpg" } ] } ]
"promo": [], - ID al promoțiilor la care să se asocieze produsul
"product_group": [574] - ID al grupurilor la care să se lege produsul
8. Grupuri de produse:**
[GET] external/product-group/ - toate grupurile site-ului
[GET] external/product-group/{service_id} - un grup
[PUT] external/product-group/bulk-update/ - actualizarea mai multor grupuri
[POST] external/product-group/bulk-create/ - crearea mai multor grupuri
[
{
"id": 134,
"code": null,
"name": "test",
"select_specifications": [42,43], #ID-ul caracteristicilor pentru grup
"images_specifications": [45,46] #ID-ul caracteristicilor pentru grup
}
]
9. Endpointpentru promoții*
[GET] external/promo/ - toate promoțiile site-ului
[GET] external/promo/{promo_id} - o promoție
[PUT] external/promo/{promo_id} - actualizează 1 promoție
[POST] external/promo/bulk-update/ -actualizează mai multe promoții*
[
{
"id": 26,
"name_ro": "Toamna ta - reducerile noastre! Boxenew",
"name_ru": "Autumn good discounts! Boxe5",
"name_en": "Promo name",
"name_uk": "Promo Name",
"hide": false,
"info": null,
"expire_date": "2024-03-04T08:15:00",
"position": 10,
"priority": 0,
"slug": "toamna-ta-reducerile-noastre-boxenew",
"show_in_promo_block": false,
"show_is_slider": false,
"show_on": null
},
{
"id": 25,
"name_ro": "smartpromonew",
"name_ru": "smartpromoru5",
"name_en": "Promo nameEN",
"name_uk": "Promo Name",
"hide": false,
"info": null,
"expire_date": "2025-02-28T17:30:00",
"position": 1,
"priority": 10,
"slug": "smartpromonew",
"show_in_promo_block": false,
"show_is_slider": false,
"show_on": "start"
}
]
[POST] external/promo/bulk-create/ - creează mai multe promoții
[
{
"name_ro": "Toamna ta - reducerile noastre! Boxenew",
"name_ru": "Autumn good discounts! Boxe5",
"name_en": "Promo name",
"name_uk": "Promo Name",
"hide": false,
"info": null,
"expire_date": "2024-03-04T08:15:00",
"position": 10,
"priority": 0,
"slug": "toamna-ta-reducerile-noastre-boxenew",
"show_in_promo_block": false,
"show_is_slider": false,
"show_on": null
},
{
"name_ro": "smartpromonew",
"nameru": "smartpromoru5", "nameen": "Promo nameEN", "nameuk": "Promo Name", "hide": false, "info": null, "expiredate": "2025-02-28T17:30:00", "position": 1, "priority": 10, "slug": "smartpromonew", "showinpromoblock": false, "showisslider": false, "showon": "start" } ]
10. Numerele de telefoane:
[GET] external/phone/ - toate numerele de telefoane ale site-ului
{
"count": 5,
"next": null,
"previous": null,
"results": [
{
"id": 254,
"phone": "+373 60 11 11 11 11"
},
{
"id": 277,
"phone": "+373 60 11 11 11 12"
},
{
"id": 278,
"phone": "+373 60 11 11 11 13"
}
]
}
[GET] external/phone/{service_id} - un singur număr de telefon
[PUT] external/phone/bulk-update/ - actualizează cîteva number de telefon
[
{
"id": 1,
"phone": "+373 60 11 11 11 11"
},
{
"id": 2,
"phone": "+373 60 11 11 11 12"
}
]
[POST] external/phone/bulk-create/ - crează cîteva numbere de telefon
[
{
"phone": "+373 60 11 11 11 11"
},
{
"phone": "+373 60 11 11 11 12"
}
]
11. Endpoint pentru company
[GET] external/company/ - toate companiile site-ului
este disponibilă filtrarea după lastupdate
Example:
/external/company?lastupdate=1749798794 - întoarce toate companiile actualizate după timpul setat
[GET] external/company/{id} - o singură company
[PUT] external/company/bulk-update/ - actualizează cîteva companii
[POST] external/company/bulk-create/ - *crează cîteva companii*
[
{
"company_owner_id": 177581,
"company_name": "Test",
"vat_rate": "55.55",
"vat_number": "555555",
"legal_address": "Socoleni 9",
"physical_address": "",
"bank_name": "MICB",
"fiscal_code":"FISCAL_CODE_123",
"bank_code": "BANK_CODE_123",
"iban": "QWEWRTYU12345",
"cif": "20000000000",
"registration_number": "2900000000",
"region": "Ciocana",
"locality": "Chisinau",
"use_vat": false,
"credit_limit": "555.00",
"balance": "55555.00",
}
]
12. Endpoint pentru magazine (filiale)
[GET] external/shop/ - toate magazinele site-ului
*[GET] external/shop/{id} - *un singur magazin
[PUT] external/shop/bulk-update/ - actualizează cîteva magazine
[
{
"id": 333,
"lat": "47.04425769408643",
"lon": "28.8317133350053",
"tooltip_pin_text": "test test",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
"order": 55,
"description_ro": null,
"description_ru": null,
"description_en": null,
"description_uk": null,
"iframe": "",
"company_id": null,
"is_active": true,
"phones": [
{
"id": 4,
"phone": "+373 60 11 11 14"
},
{
"id": 3,
"phone": "+373 60 11 11 13"
}
],
"addresses": {
"region_id": 3,
"locality_id": 70,
"sector_id": 10,
"address": "Vadul lui Voda 78/2",
"house": null,
"entrance": null,
"apartment": null,
"zip_code": null
}
}
]
[POST] external/shop/bulk-create/ - crează cîteva magazine
[
{
"lat": "47.04425769408643",
"lon": "28.8317133350053",
"tooltip_pin_text": "test test",
"email": "[[email protected]](https://docs.ecom.md/cdn-cgi/l/email-protection)",
"order": 55,
"description_ro": null,
"description_ru": null,
"description_en": null,
"description_uk": null,
"iframe": "",
"company_id": null,
"is_active": true,
"phones": [
{
"id": 1,
"phone": "+373 60 11 11 11"
},
{
"id": 2,
"phone": "+373 60 11 11 12"
}
]
}
]
[POST] external/product/user-price-update/ - actualizare/creare prețuri pentru diferite tipuri de utilizatori**
[
{
"user_type_id": 10,
"price": 8888,
"group_product_id": “349254”
}
]
[POST] external/product/shop-update/ - *actualizare/creare* stock în magazine **
[
{
"shop_id": 281,
"qty": 9999,
"group_product_id": “349254”
}
]
13. Endpoint pentru carduri de reducere
[GET] external/discount-card/ - toate cardurile site-ului
[GET] external/discount-card/{id} - un singur card de reducere
[PUT] external/discount-card/{id} - actualizează un card de reducere
[PUT] external/discount-card/bulk-update/ - *actualizează cîteva carduri de reducere*
[POST] external/discount-card/bulk-create/ - *crează cîteva carduri de reducere*
{
"id": 1,
"user_id": null,
"code": "1234567890123",
"legal_entity_name": "test address",
"first_name": "Test",
"last_name": "Test",
"barcode": "123456789012378476234768", #cod unic
"accumulated_amount": "5166.00",
"sex": "m",
"date_of_birth": "2006-07-08",
"address": "test address"
}
14.Endpoint „Entități personalizate”**
Dacă site-ul necesită anumite entități suplimentare, cum ar fi Autor, Editură, etc., acestea pot fi create, actualizate și asociate cu produsele.
[GET] external/custom-instance/ - toate entitățile personalizate ale site-ului
[GET] external/custom-instance/{id} - o entitate personalizată a site-ului
[PUT] external/custom-instance/{id} - *actualizează entitatea personalizată a site-ului*
[PUT] external/custom-instance/bulk-update/ - *actualizează mai multe entități personalizate
[POST] external/custom-instance/bulk-create/ - *crează* mai multe entități personalizate*
{
"slug": "author22",
"active": true,
"group_code_id": "code25",
"order": 4,
"name_ro": "Author_ro2",
"name_ru": "Author_ru2",
"name_en": "Author_en2",
"name_uk": "Author2",
"plural_name_ro": "Author_ro2",
"plural_name_ru": "Author_ru2",
"plural_name_en": "Author_en2",
"plural_name_uk": "Author_uk2",
"seo_title_ro": "int",
"seo_title_ru": "int",
"seo_title_en": "int",
"seo_title_uk": "int",
"seo_keywords_ro": "int",
"seo_keywords_ru": "int",
"seo_keywords_en": "int",
"seo_keywords_uk": "int",
"seo_description_ro": "int",
"seo_description_ru": "int",
"seo_description_en": "int",
"seo_description_uk": "int"
}
15. Endpoint „Elemente ale entităților personalizate”
Dacă site-ul necesită anumite entități suplimentare, de exemplu Author, Editură etc.
Se creează entitatea „Autor” și în ea se pot introduce elementele acestei entități, de exemplu „Autor1”, „Autor2”.
[GET] external/custom-instance-item/ - toate elementele personalize ale site-ului
[GET] external/custom-instance-item/{id} - un element al entității personalizate a site-ului
[PUT] external/custom-instance-item/{id} - actualizează elementele entității personalize a site-ului
[PUT] external/custom-instance-item/bulk-update/ - *actualizează mai multe elemente ale entităților personalizate*
[POST] external/custom-instance-item/bulk-create/ - crează mai multe elemente ale entităților personalizate
{
"id": 1,
"slug": "author3556",
"active": true,
"group_code_id": "12455",
"order": 5,
"custom_instance": 1, #ID-ul elementului din „Entități personalizate”, de exemplu „Autor”
"name_ro": "Author_name_ro3",
"name_ru": "Author_name_ro3",
"name_en": "Author_name_ro3",
"name_uk": "Author_name_ro3",
"description_ro": "Author_description_ro3",
"description_ru": "Author_description_ro3",
"description_en": "Author_description_ro3",
"description_uk": "Author_description_ro3",
"seo_title_ro": "seo_title3",
"seo_title_ru": "seo_title3",
"seo_title_en": "seo_title3",
"seo_title_uk": "seo_title3",
"seo_keywords_ro": "seo_keywords3",
"seo_keywords_ru": "seo_keywords3",
"seo_keywords_en": "seo_keywords3",
"seo_keywords_uk": "seo_keywords3",
"seo_description_ro": "seo_description3",
"seo_description_ru": "seo_description3",
"seo_description_en": "seo_description3",
"seo_description_uk": "seo_description3"
}
Was the article helpful?
Yes, thank you! Unfortunately no