- Obțineți un token de site de la manager:
[POST] - {domeniu}/extern/categorie/
{domain**}=admin.ecom.md
- Adăugați un token la anteturi
Toate câmpurile care sunt returnate sunt, de asemenea, disponibile pentru actualizare.
Categorii:
[GET] - {domain}/external/category/ - obțineți toate categoriile de site
{
„id”: 2964, (INT) - ID în baza noastră de date
„poziție”: 10, INT - poziția categoriei 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",
„hide”: fals, Hidden\Open
"description_ro": null,
"description_ru": nul,
„description_en”: nul,
„description_uk”: nul,
„description_position”: nul,
"group_category_id": "testing-phone-cat-id", (STR) - Orice identificator convenabil pentru dvs. (ID din baza 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-ul categoriei părinte (int)
}
[GET] - {domain}/external/category/{id} - obțineți o categorie
[PUT] - {domain}/external/category/{id}/ - actualizare 1 categorie
[POST] - {domain}/external/category/bulk-create/ - Creați 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 caracteristicilor:
[GET] - {domain}/external/specification/ - obțineți toate specificațiile site-ului
[GET] - {domain}/external/specification/{id} - obțineți o specificație
[PUT] - {domeniu}/extern/specification/{id}/ - actualizare 1 specificație
[POST] - {domain}/external/specification/bulk-create/ - *create*mai multe specificații
[PUT] - {domain}/external/specification/bulk-update/ - *actualizare mai multe specificații*
*6.*Crearea/actualizarea valorilor caracteristice:
[GET] - {domain}/external/specification-value/ - obțineți toate valorile specificațiilor site-ului
*[GET] - {domain}/external/specification-value/{id} -obține o valoare de specificație*
[PUT] - {domain}/external/specification-value/{id}/ - actualizează 1 specificație de valori
[POST] - {domain}/external/specification-value/bulk-create/ - creează mai multe valori caracteristice
[PUT] - {domain}/external/specification-value/bulk-update/ - *actualizare mai multe valori ale specificațiilor*
7.Produse**:
[GET] - {domain}/external/product/ - obțineți toate produsele de pe site
[GET] - {domain}/external/product/{id} - obțineți un produs
[POST] - {domain}/external/product/bulk-create/ - creați mai multe produse*
În obiect este necesar să trecem 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,
„brand_id”: 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, „original_name”: „6d44a748-d164-11ee-ae36-0025905ed821.jpg” } ] } ]
„promo”: [], - ID-ul acțiunilor la care să se conecteze produsul
„product_group”: [574] - ID-ul grupurilor la care să se conecteze produsul
8. Grupe de produse:
[GET] external/product-group/ - toate grupurile de site-uri
[GET] external/product-group/{service_id} - un grup
[PUT] external/product-group/bulk-update/ - actualizează mai multe grupuri
[POST] external/product-group/bulk-create/ - creează mai multe grupuri
[
{
„id”: 134,
„cod”: nul,
"nume": "test",
"select_specifications": [42,43], - ID caracteristici pentru grup
"images_specifications": [45,46] - ID-ul caracteristicilor pentru grup
}
]
9. Punct final pentru stocuri
*[GET] extern/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 distribuiri
[
{
"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",
"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",
„showinpromoblock”: fals, „showisslider”: fals, "showon": "începe" } ]
10. numere de telefon
[GET] extern/telefon/ - toate telefoanele de pe site
{
„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 telefon
[PUT] extern/telefon/actualizare în bloc/ - actualizare mai multe telefoane
[
{
„id”: 1,
„telefon”: „+373 60 11 11 11 11”
},
{
„id”: 2,
„telefon”: „+373 60 11 11 11 12”
}
]
[POST] external/phone/bulk-create/ - creează mai multe telefoane
[
{
„telefon”: „+373 60 11 11 11 11”
},
{
„telefon”: „+373 60 11 11 11 12”
}
]
11. Punct final pentru companii
[GET] extern/companie/ - toate companiile de pe site
Este disponibilă filtrarea după lastupdate
De exemplu:
/external/company?lastupdate=1749798794 - va returna toate companiile actualizate după un timp specificat
[GET] external/company/{id} - o companie
[PUT] external/company/bulk-update/ - actualizare mai multe companii
[POST] external/company/bulk-create/ - creați mai multe 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. Punct final pentru magazine (sucursale)
[GET] extern/magazin/ - toate magazinele de pe site
[GET] external/shop/{id} - un magazin
[PUT] external/shop/bulk-update/ - actualizează mai multe magazine
[
{
„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": nul,
"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/ - creează mai multemagazine**
[
{
"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": nul,
"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/ - actualizarea/crearea prețurilor pentru diferite tipuri de utilizatori
[
{
„user_type_id”: 10,
„preț”: 8888,
„group_product_id”: „349254”
}
]
[POST] extern/produs/shop-update/ - actualizare/creare disponibilitate în magazine
[
{
„shop_id”: 281,
„cantitate”: 9999,
„group_product_id”: „349254”
}
]
13. Punct final pentru cardurile de reducere
[GET] extern/card-reducere/ - toate cardurile de site
[GET] external/discount-card/{id} - un card
[PUT] external/discount-card/{id} - actualizare 1 card
[PUT] extern/card-reducere/actualizare în bloc/ - actualizare mai multe carduri
[POST] external/discount-card/bulk-create/ - creați mai multe carduri
{
„id”: 1,
„user_id”: nul,
"cod": "1234567890123",
"legal_entity_name": "adresa de testare",
"first_name": "Test",
"last_name": "Test",
„cod de bare”: „123456789012378476234768”, câmp #unique "accumulatedamount": "5166.00", "sex": "m", "dataof_birth": "2006-07-08", "address": "adresă de test" }
14.Punctul final „Entități personalizate”**
Dacă site-ul necesită unele dintre propriile entități suplimentare, de exemplu Autor, Editor etc., acestea pot fi create, actualizate și legate la produse.
[GET] external/custom-instance/ - toate entitățile personalizate ale site-ului
[GET] external/custom-instance/{id} - o entitate personalizată de site
[PUT] external/custom-instance/{id} - actualizați entitatea personalizată a site-ului
[PUT] external/custom-instance/bulk-update/ - actualizează mai multe entități personalizate
*[POST] external/custom-instance/bulk-create/ - *creează 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. Punct final „Elemente ale entităților personalizate”
Dacă site-ul necesită unele dintre propriile entități suplimentare, de exemplu Autor, Editor etc.
Este creată entitatea „Autor” și elementele acestei entități pot fi inserate în ea, de exemplu „Author1”, „Author2”.
[GET] external/custom-instance-item/ - toate elementele sunt entități personalizate de site
[GET] external/custom-instance-item/{id} - un element al unei entități personalizate de site
[PUT] external/custom-instance-item/{id} - actualizează elemente personalizate de entitate de site
[PUT] external/custom-instance-item/bulk-update/ - actualizează mai multe elemente entități personalizate
[POST] external/custom-instance-item/bulk-create/ - creați mai multe elemente personalizate de entitate
{
„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