Pieslēdziet custom veikalu Zeronode

• Pieprasījumi nāk no mūsu serveriemNevis no apmeklētāja pārlūka, tāpēc CORS headeri nav vajadzīgi.
• GET pieprasījums, atbilde JSONVisi pieprasījumi ir GET ar query parametriem.
• ĀtriGaidām atbildi līdz 8 sekundēm, bet mērķis ir zem sekundes. Meklēšana notiek tajā pašā laikā, kad asistents raksta atbildi.
• Nosaukumi var būt jūsuLauku un parametru nosaukumus izvēlaties paši, mēs tos mapojam savā pusē. Iespējams, pietiks ar esošu iekšējo API, tāpēc vienkārši atsūtiet to mums.
• Saraksts var būt jebkurAtbilde var būt uzreiz masīvs vai atrasties kāda lauka iekšā, piemēram, items vai data.products.
• Tikai publicēti produktiAtgrieziet tikai produktus, ko apmeklētājs var atvērt un nopirkt.
• Viena valoda pieprasījumāJa veikalā ir vairākas valodas, pieņemiet parametru (piem., lang=lv) vai dodiet katrai valodai savu base URL. Nosaukumiem, aprakstiem un URL jābūt tajā pašā valodā.

Autentifikācija

Izvēlieties vienu. Dodiet atslēgai tikai kataloga lasīšanas tiesības.

{
  "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" }
      ]
    }
  ]
}

Kļūdas

200

Nav rezultātu: tukšs saraksts.

404

Produkts ar tādu id nav atrasts.

401 / 403

Nepareiza vai trūkstoša atslēga. Mūsu lietotne atzīmē savienojumu kā bojātu, tāpēc kļūda nepaliek nepamanīta.

JSON

Kļūdas atgrieziet kā JSON, nevis HTML error lapu vai botu pārbaudi. Ja API priekšā ir firewall, ielaidiet mūsu pieprasījumus.

Ar groza hookiem asistents var ielikt produktus apmeklētāja grozā. Kodu rakstām mēs: tas darbojas apmeklētāja pārlūkā jūsu lapā, viņa paša sesijā, un jums nekas nav jāpievieno. Pastāstiet mums, kā skripts jūsu lapā var izdarīt šīs četras lietas:

1. Pievienot grozamProdukta id, daudzums un variants (ja ir varianti) pašreizējā apmeklētāja grozā.
2. Nolasīt groza saturuGrozā esošo produktu id un daudzumi.
3. Atvērt grozuParasti pietiek ar groza lapas URL.
4. Pievienot atlaižu koduTikai tad, ja izmantojat atlaižu kodus.

Der gan JavaScript funkcija, gan tā paša domēna endpoints. Izmantojiet tos pašus produktu id, kas API.

// Funkcija lapā …
await window.shop.cart.add({ id: '48213', quantity: 1 })

// … vai tā paša domēna endpoints, kas izmanto sesijas cookie
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>

Ja jūsu vietne izmanto Content-Security-Policy headeri, atļaujiet šos hostus. Widgetam nav vajadzīgs ne unsafe-eval, ne inline skripti.

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 un read-only atslēga.
2. Viens meklēšanas URL, kas atgriež rezultātus.
3. Viens produkta id, ar ko varam testēt.
4. Groza hookiem: funkcija vai endpoints un groza lapas URL.