A partner ecosystem created to grow business

AI Commerce offers a GraphQL interface (Apollo), through which partners can retrieve the data they need – for example, products, prices, or countries.

Why GraphQL?

1. Customized queries: The partner can specify exactly what data is returned, avoiding unnecessary data transfer.

2. Fewer requests: Complex database queries can be combined into a single GraphQL request instead of multiple calls to a REST interface.

3. Unified interface: All data can be retrieved through the same endpoint.

Example of a GraphQL query (POST)

{
  "query": "{
    products(limit: 5, offset: 0) {
      id
      name
      price
    }
  }"
}

Request response (JSON)

{
  "data": {
    "products": [
      { "id": "632", "name": "721H",       "price": 89.9 },
      { "id": "637", "name": "TC7092",     "price": 49.9 },
      { "id": "697", "name": "JERONE50EUR","price": 50   },
      { "id": "698", "name": "JERONE100EU","price": 100  },
      { "id": "699", "name": "JERONE200EU","price": 200  }
    ]
  }
}

Secured headers

Every GraphQL request requires, among other things:

• X-GraphQL-Secret: AI Commerce's security key

• X-Tenant-Id: Store alias (e.g. “boeing”)

• X-Tenant-Secret: Tenant’s own API key

We recommend always using AI Commerce's internal load balancer address, APP_LOAD_BALANCER_URL, to ensure the request remains fast and secure within AI Commerce's VPC.

Rate Limiting

Our system limits the number of requests (e.g. 100 requests / 5 min per tenant). In case of exceeding limits, a 429 Too Many Requests response will be returned.