- Obțineți token-ul site-ului de la manager:
[POST] - {domeniu}/extern/categorie/
*
{domain}=admin.ecom.md*
- Adăugați token-ul la antet
Toate câmpurile returnate sunt disponibile și pentru actualizare
Categorii :
[GET] - {domain}/external/category/ - obține toate categoriile site-ului
{
"id": 2964, #(INT) ID on baza noastră de date
"position": 10, #INT - poziția categorii pe site în meniu
"name_ro": "Telefoane",
"name_ru": "Telefoane",
„name_en”: nul,
„name_uk”: nul,
"slug_ro": "telefoane-1",
"slug_ru": "telefony",
"slug_en": "telefoane-1",
"slug_uk": "telefoane-1",
„ascunde”: fals, #Deschisă/Închisă
"description_ro": null,
"description_ru": nul,
„description_en”: nul,
„description_uk”: nul,
„description_position”: nul,
"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": nul,
"meta_description_en": null,
"meta_description_uk": null,
"meta_title_ro": nul,
"meta_title_en": nul,
"meta_title_en": nul,
„meta_title_uk”: nul,
"meta_keywords_ro": null,
„meta_keywords_ru”: nul,
„meta_keywords_en”: null,
„meta_keywords_uk”: nul,
„show_18_popup”: adevărat,
„category_id”: null - ID categorie categorie (int)
}
[GET] - {domain}/external/category/{id} - obține o categorie
*[PUT] - {domain}/external/category/{id}/ - *actualizează 1 categorie
*[POST] - {domain}/external/category/bulk-create/ - *creează mai multe categorii
*[PUT] - {domain}/external/category/bulk-update/ - *actualizează mai multe categorii**
{
„id”: 27,
„poziție”: 9,
"name_ro": "Acustica de casa Hi-Fi",
"name_ru": "Difuzoare Hi-Fi de acasă",
"name_en": "",
"name_uk": "",
"slug_ro": "acustica-de-casa",
"slug_ru": "acustica-de-casa",
"slug_en": "acustica-de-casa",
„slug_uk”: nul,
„ascunde”: fals,
...
}
[PUT] - {domain}/external/category/{id}/bulk-update/
[
{
„id”: 27,
„poziție”: 9,
"name_ro": "Acustica de casa Hi-Fi",
"name_ru": "Difuzoare Hi-Fi de acasă",
"name_en": "",
"name_uk": "",
"slug_ro": "acustica-de-casa",
"slug_ru": "acustica-de-casa",
"slug_en": "acustica-de-casa",
„slug_uk”: nul,
„ascunde”: fals,
...
},
{
„id”: 28,
„poziție”: 9,
"name_ro": "Acustica de casa Hi-Fi",
"name_ru": "Difuzoare Hi-Fi de acasă",
"name_en": "",
"name_uk": "",
"slug_ro": "acustica-de-casa",
"slug_ru": "acustica-de-casa",
"slug_en": "acustica-de-casa",
„slug_uk”: nul,
„ascunde”: fals,
...
}
]
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 obiectul obligatoriu transmite groupproductid sau ID din baza noastră de date.
Exemplu de sarcină utilă:
[
{
„marcaj”: adevărat,
"preț": "1399,00",
„cantitate”: 9,
„prioritate_sort”: 0,
"old_price": "1099,00",
"group_product_id": "new_product_testt",
„greutate”: nul, „înălțime”: nul, „lățime”: nul, „lungime”: nul, „brandid”: nul, "cuvinte cheie": "", „specificații”: [ { „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”: nul, "slugro": "jbl-jbl-tune-720-bt-white1", "slugru": "jbl-jbl-tune-720-bt-white1", "slugen": "jbl-jbl-tune-720-bt-white1", „sluguk”: nul, "shortdescriptionro": null, "shortdescriptionru": nul, „shortdescriptionen”: nul, „shortdescriptionuk”: nul, "descriptionro": "test de testare", "descriptionen": "test de testare", „descriptionen”: nul, „descriptionuk”: nul, "unitmeasurementro": nul, „unitmeasurementru”: nul, „unitmeasurementen”: nul, „unitmeasurementuk”: nul, "seotitlero": nul, "seotitleru": nul, „seotitleen”: nul, „seotitleuk”: nul, "seodescriptionro": null, "seodescriptionru": nul, "seodescriptionen": null, „seodescriptionuk”: nul, "seokeywordsro": null, "seokeywordsru": nul, „seokeywordsen”: nul, „seokeywordsuk”: nul, "cod": "qwer12344", „categorie”: [ 1020 ], "imagini": [ { "comanda": 1, „originalname”: „2e0b4c7e383f463687a9e66fb3dc66a2.jpg” }, { "comanda": 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,
„cod”: nul,
"nume": "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": "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"
}
]
[POST] external/promo/bulk-create/ - creează mai multe promoții
[
{
"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
},
{
"name_ro": "smartpromonew",
"nameru": "smartpromoru5", "nameen": "Nume promoționalEN", "nameuk": "Numele promoției", „ascunde”: fals, „informații”: nul, „expiredate”: „2025-02-28T17:30:00”, „poziție”: 1, „prioritate”: 10, "slug": "smartpromonew", „showinpromoblock”: fals, „showisslider”: fals, "showon": "începe" } ]
10. Numerele de telefoane:
[GET] external/phone/ - toate numerele de telefoane ale site-ului
{
„număr”: 5,
„următorul”: nul,
„anterior”: nul,
„rezultate”: [
{
„id”: 254,
„telefon”: „+373 60 11 11 11 11”
},
{
„id”: 277,
„telefon”: „+373 60 11 11 11 12”
},
{
„id”: 278,
„telefon”: „+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,
„telefon”: „+373 60 11 11 11 11”
},
{
„id”: 2,
„telefon”: „+373 60 11 11 11 12”
}
]
[POST] external/phone/bulk-create/ - crează cîteva numbere de telefon
[
{
„telefon”: „+373 60 11 11 11 11”
},
{
„telefon”: „+373 60 11 11 11 12”
}
]
11. Endpoint pentru companie
[GET] external/company/ - toate companiile site-ului
este disponibilă filtrarea după lastupdate
Exemplu:
/external/company?lastupdate=1749798794 - întoarce toate companiile actualizate după timpul setat
[GET] external/company/{id} - o singură companie
[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",
„localitate”: „Chișinău”,
„use_vat”: fals,
"credit_limit": "555.00",
"sold": "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ă revista cîteva
[
{
„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
}
}
]
[POST] external/shop/bulk-create/ - crează cîteva magazine
[
{
"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”: 1,
„telefon”: „+373 60 11 11 11”
},
{
„id”: 2,
„telefon”: „+373 60 11 11 12”
}
]
}
]
[POST] external/product/user-price-update/ - actualizare/creare prețuri pentru diferite tipuri de utilizatori**
[
{
„user_type_id”: 10,
„preț”: 8888,
„group_product_id”: „349254”
}
]
[POST] external/product/shop-update/ - *actualizare/creare* stock in magazine **
[
{
„shop_id”: 281,
„cantitate”: 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”: nul,
"cod": "1234567890123",
"legal_entity_name": "adresa de testare",
"first_name": "Test",
"last_name": "Test",
„cod de bare”: „123456789012378476234768”, #cod unic
"accumulated_amount": "5166.00",
"sex": "m",
"data_of_birth": "2006-07-08",
"address": "adresă de test"
}
14.Punctul final „Entități personalizate”**
Dacă site-ul necesită anumite entități suplimentare, ar fi Autor, Editură, etc., acestea pot fi create, actualizate și asociate cu produsele.
[GET] external/custom-instance/ - toate entități 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": "autor22",
„activ”: adevărat,
"group_code_id": "code25",
"comanda": 4,
"name_ro": "Author_ro2",
"name_ru": "Author_ru2",
"name_en": "Author_en2",
"name_uk": "Autor2",
"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, exemplu Author, Editură etc.
Se creează entitatea „Autor” și în ea se pot introduce elementele acestor 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": "autor3556",
„activ”: adevărat,
"group_code_id": "12455",
"comanda": 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": "Nume_autor_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"
}
A fost util articolul?
Da, multumesc! Din pacate nu