Pieprasījumi ļauj iegūt aktuālus produktu datus no tiešsaistes veikala. Lūdzu, skatiet šo dokumentāciju, lai pareizi apstrādātu pieprasījumus no mums.

HTTP POST pieprasījums

Pieprasījuma galvene:

Authorization: Bearer {jūsu unikālais pilnvara},
Content-Type: application/json,
 

Pieprasījuma getProducts piemērs:

{
   "method": "getProducts",
   "details": 0, 
   "offset": 0,
   "count": 10
}

VārdsVeidsVērtībaKomentāri
methodVirknegetProducts 
detailsBoole-vērtība0: pieprasīt pamatinformāciju
1: pieprasīt detalizētu produktu informāciju		Detalizēta informācija tiek pieprasīta jaunu produktu importam vai ja produktu dati ir mainījušies (atpazīstami pēc atbildes ziņojuma "updated" lauka). Esošiem produktiem tiek pieprasīta tikai pamatinformācija, piemēram, cena un pieejamība.
offsetVirkneLastId vērtība no atbildes ziņojumaIzmanto, lai turpinātu saraksta attēlošanu no pēdējā zināmā punkta
countVirkne Produktu skaits, kas tiks nodrošināts

 

Pieprasījuma getProductsBySku piemērs:

{
   "method": "getProductsBySku",
   "details": 1,
   "sku": [
        "12312321",
        "21312312",
        "12321321"
   ]
}

VārdsVeidsVērtībaKomentāri
methodVirknegetProductsBySku 
detailsBoole-vērtība0: pieprasīt pamatinformāciju
1: pieprasīt detalizētu produktu informāciju		Detalizēta informācija tiek pieprasīta jaunu produktu importam vai ja produktu dati ir mainījušies (atpazīstami pēc atbildes ziņojuma "updated" lauka). Esošiem produktiem tiek pieprasīta tikai pamatinformācija, piemēram, cena un pieejamība.
skuMassīvsSKU sarakstsMassīvs ar SKU sarakstu, kas tiek nodrošināts

 

Atbildes piemērs:

{
   "prods": [
       {
           "sku": 12345678,
           "url": "https://example.com",
           "manufacturer": "Example Manufacturer",
           "model": "Example Model",
           "ean": "1234567890123",
           "price": 9.99,
           "availability": "InStock",
           "itemsAvailable": 42,
           "updated": "2020-02-20 15:44:49"
       }
   ],
   "lastId": 1234
}

Atbilde ar iestatītu details karodziņu:
{
   "prods": [
       {
           "sku": "12345678",
           "url": "https://example.com",
           "manufacturer": "Example Manufacturer",
           "model": "Example Model",
           "ean": "1234567890123",
           "price": 9.99,
           "availability": "InStock",
           "itemsAvailable": 42,
           "itemCondition": "NewCondition",
           "category": "Example Category",
           "name": "Example Product",
           "description": "Example Product Description",
           "updated": "2020-02-20 15:44:49",
           "delivery": [
               {
                   "country": [
                       "BE",
                       "DE"
                   ],
                   "carriers": [
                       {
                           "name": "UPS",
                           "shippingRate": 9.99,
                           "deliveryDays": 3
                       },
                       {
                           "name": "PickupInStore",
                           "shippingRate": 0,
                           "deliveryDays": 0,
                           "inStore": 1
                       }
                   ]
               },
               {
                   "country": "PL",
                   "carriers": [
                       {
                           "shippingRate": 5,
                           "name": "UPS",
                           "deliveryDays": 3
                       },
                         {
                           "shippingRate": 9.99,
                           "name": "UPS",
                           "deliveryDays": 2
                       }
                   ]
               }
           ],
           "images": [
                   "https://example.com/image1.jpg",
                   "https://example.com/image2.jpg",
                   "https://example.com/image3.jpg"
           ]
       }
   ],
   "lastId": 1234
}

Response fields description:

Vārds Veids Prasība Apraksts
prods.sku Virkne Obligāts Unikāls veikala produkta identifikācijas numurs
prods.url Virkne Obligāts Produkta lapas URL
prods.manufacturer Virkne Nosacīts Produkta ražotājs
prods.model Virkne Nosacīts Produkta modelis (ražotāja kods vai mpn)
prods.ean Skaitlis Nosacīts Produkta EAN-13 kods
prods.price Decimālskaitlis Obligāts Produkta cena, iekļaujot PVN
prods.availability Virkne Obligāts Preces pieejamība, saskaņā ar schema.org izklāstu
prods.itemsAvailable Vesels skaitlis Neobligāts Produktu skaits noliktavā, pieejams pirkumam
prods.itemCondition Virkne Obligāts Piedāvājuma produkta stāvoklis, saskaņā ar schema.org izklāstu
prods.name Virkne Obligāts Produkta nosaukums
prods.category Virkne Obligāts Produkta kategorija
prods.description Virkne Neobligāts Produkta īss apraksts
prods.updated Virkne Obligāts Produkta detaļu modificēšanas datums formātā “GGGG-MM-DD stundas:minūtes:sekundes”
prods.delivery Apzīmējumu virkņu masīvs Obligāts Produkta piegādes opcijas (pārbaudiet apzīmējumu virkņu masīva aprakstu zemāk)
prods.images Apzīmējumu virkņu masīvs Neobligāts Produkta attēlu saraksts
prods.lastId Vesels skaitlis Obligāts Pēdējā produkta unikālais ieraksta identifikācijas numurs. Šo vērtību izmanto kā nobīdi getProducts pieprasījumā, lai turpinātu produktu sarakstu
'Delivery' masīva apraksts
Vārds Veids Prasība Apraksts
prods.delivery.country Virkne/Masīvs Obligāts Valsts kods ISO 3166, kur veikals spēj piegādāt. Līdzīgu piegādes likmju un laiku valstīm var sniegt valstu kodu masīvu
prods.delivery.carriers Masīvs Obligāts 'Carriers' masīvs (masīva aprakstu skatiet tālāk)
'Carriers' masīva apraksts
Vārds Veids Prasība Apraksts
prods.delivery.carriers.name Virkne Obligāts Pārvadātāja nosaukums
prods.delivery.carriers.shippingRate Decimālskaitlis Obligāts Piegādes izmaksas par produktu
prods.delivery.carriers.deliveryDays Vesels skaitlis Obligāts Prognozētais piegādes laiks dienās
prods.delivery.carriers.inStore Booleans Neobligāts Ja ir iestatīts, norāda, ka produktu var saņemt veikalā bez piegādes

Lauki, kuru nosaukumi atzīmēti treknrakstā, tiek gaidīti pieprasījumā ar karodziņu 'details', kas iestatīts uz 0.