Connect a custom store to Zeronode

• Called from our serversNot from the visitor’s browser, so you need no CORS headers.
• GET with JSON backEvery call is a GET request with query parameters.
• FastWe wait up to 8 seconds per call; aim for under one second. Searches run while the assistant is replying.
• Your names are fineField and parameter names are your choice; we map them on our side. An existing internal API may already be enough, so send us what you have.
• Lists anywhereA list can be the whole response or sit inside one field, such as items or data.products.
• Published products onlyReturn only products a visitor can open and buy.
• One language per callWith several languages, accept a parameter such as lang=en or serve each language under its own base URL. Names, descriptions and URLs in that language.

Authentication

Pick one. Give the key read access to the catalogue only.

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

Errors

200

No results: an empty list.

404

Unknown product id.

401 / 403

Wrong or missing key. Our app flags the connection as broken, so it never fails silently.

JSON

Errors as JSON, never an HTML error page or a bot-protection challenge. If a firewall sits in front of the API, let our requests through.

With cart hooks, the assistant can add products to the visitor’s cart. We write that code. It runs in the visitor’s browser on your pages, in their own session, and you don’t paste anything. Tell us how a script on your page can do these four things:

1. Add to cartProduct id, quantity and variant (if you have variants), added to the current visitor’s cart.
2. Read the cartThe product ids and quantities in it.
3. Open the cartUsually just the cart page URL.
4. Apply a couponOnly if you offer coupons.

A JavaScript function or a same-origin endpoint both work. Use the same product ids as the API.

// A function on the page …
await window.shop.cart.add({ id: '48213', quantity: 1 })

// … or a same-origin endpoint that uses the session 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>

If your site sends a Content-Security-Policy, allow these hosts. The widget needs neither unsafe-eval nor inline scripts.

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

1. The API base URL and a read-only key.
2. One search URL that returns results.
3. One product id we can test with.
4. For cart hooks: the function or endpoint, and the cart page URL.