Ühenda custom e-pood Zeronode’iga

• Päringud tulevad meie serveritestMitte külastaja brauserist, nii et CORS-i headereid pole vaja.
• GET-päring, vastuseks JSONKõik päringud on GET-id query parameetritega.
• KiireOotame vastust kuni 8 sekundit, aga eesmärk võiks olla alla sekundi. Otsing käib samal ajal, kui assistent vastust kirjutab.
• Nimed võivad olla sinu omadVäljade ja parameetrite nimed vali ise, me mapime need enda poolel. Võib-olla piisab ka olemasolevast sisemisest API-st, nii et saada see meile.
• Loend võib olla ükskõik kusVastus võib olla kohe massiiv või paikneda mõne välja all, näiteks items või data.products.
• Ainult avaldatud tootedTagasta ainult tooted, mida külastaja saab avada ja osta.
• Üks keel päringu kohtaKui poes on mitu keelt, võta vastu parameeter (nt lang=et) või anna igale keelele oma base URL. Nimed, kirjeldused ja URL-id peavad olema samas keeles.

Autentimine

Vali üks. Anna võtmele ainult kataloogi lugemise õigus.

{
  "items": [
    {
      "id": "48213",
      "name": "Glass beaker, low form, 250 ml",
      "price": 4.90,
      "currency": "EUR",
      "stock": "instock",
      "url": "https://shop.example.com/labware/glass-beaker-250-ml-48213",
      "image": "https://shop.example.com/images/48213.jpg",
      "sku": "BK-250",
      "brand": "Example Glassworks",
      "categoryIds": [12, 31],
      "description": "Borosilicate glass 3.3, heat resistant to 500 °C. Graduated from 50 to 200 ml, with spout.",
      "attributes": [
        { "name": "Volume", "value": "250 ml" },
        { "name": "Material", "value": "Borosilicate glass" }
      ]
    }
  ]
}

Vead

200

Tulemusi pole: tühi list.

404

Sellise id-ga toodet pole.

401 / 403

Vale või puuduv võti. Meie rakendus märgib ühenduse katkiseks, nii et viga ei jää märkamata.

JSON

Vead tagasta JSON-ina, mitte HTML-i error-lehe ega boti-kontrollina. Kui API ees on firewall, lase meie päringud läbi.

Ostukorvi hookidega saab assistent tooteid külastaja ostukorvi lisada. Koodi kirjutame meie: see jookseb külastaja brauseris sinu lehel, tema enda sessioonis, ja sul ei ole vaja midagi lisada. Anna meile teada, kuidas sinu lehel olev skript saab teha neid nelja asja:

1. Lisa ostukorviToote id, kogus ja variant (kui variandid on) praeguse külastaja ostukorvi.
2. Loe ostukorvi sisuOstukorvis olevate toodete id-d ja kogused.
3. Ava ostukorvEnamasti piisab ostukorvi lehe URL-ist.
4. Lisa sooduskoodAinult siis, kui kasutad sooduskoode.

Sobib nii JavaScripti funktsioon kui ka sama domeeni endpoint. Kasuta samu toote id-sid mis API-s.

// Funktsioon lehel …
await window.shop.cart.add({ id: '48213', quantity: 1 })

// … või sama domeeni endpoint, mis kasutab sessiooniküpsist
await fetch('/cart/add', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ id: '48213', quantity: 1 }),
})

<script src="https://content.zeronode.ai/zeronode-plugin.js"
        data-public-key="YOUR_PUBLIC_KEY" data-zeronode defer></script>

Kui sinu sait kasutab Content-Security-Policy headerit, luba need hostid. Widget ei vaja unsafe-evali ega inline-skripte.

Content-Security-Policy:
  script-src https://content.zeronode.ai https://api.zeronode.ai;
  connect-src https://api.zeronode.ai wss://api.zeronode.ai;

1. API base URL ja read-only võti.
2. Üks otsingu URL, mis tagastab tulemusi.
3. Üks toote id, millega saame testida.
4. Ostukorvi hookide jaoks: funktsioon või endpoint ja ostukorvi lehe URL.