SPREEAI/开发者/文档

建造与
SPREEAI.

从集成选择到测试启动的实用途径。 开始一个交易之旅,使用发行的测试访问,并将认证从浏览器代码中保留。

公共指南网页 SDK v2.1更新于2026年8月

选择整合路径

路径最好为第一次行动
Shopify 应用快速管理商店前置设置安装应用程序
网页 SDK自定义或无头网阅读 SDK 指南
iOS / Android原住民购物应用选择原住民指南
公开 API批准的服务器侧工作流开放批准的参考
亚马逊合作伙伴网络市场一体化即将推出
信用安全。 例子只适用于主持人。 SPREEAI 在登机期间批准的访问问题。 永远不要发布客户端秘密、API密钥、代币、私人主机名称或客户数据。

Shopify 应用

在 Shopify 上运行商店时使用管理的应用程序,并且不需要自定义备份。 目前的登机流连接到协议和订阅后,不需要将 API 键复制到设置屏幕。

  1. 安装官员 SPREEAI 应用并完成管理的同意流。
  2. 同步初始目录组,并审查产品准备状态。
  3. 将定位和风格定制为双重主题。
  4. 验证合格的产品、变量、移动行为和添加到地图。
  5. 仅在品牌和QA批准后发布。

开启官方 Shopify 登机指南

Web SDK 快速入门

使用 @ spreeai 网页Sdk 用于自定义的配置、风格、活动、尺寸和车辆行为。

npm 安装 @ spreeai /web-sdk import { init } 从“@” spreeai /web-sdk; const sdk = await init({ clientId:“your-client-id”,合作伙伴Id:”your-partner-id” }); sdk.renderTryOnButton({ selector:“#” spreeai -try-on", productId: product.id, enableAddToCart: true });

一次启动,仅为合格的产品提供报价,并将文件客户端呼叫回复连接到您现有分析。 确认当前的界面在 官方 Web SDK API 参考

火灾接入

使用公共 Swagger 引用仅适用于在登机期间批准的服务器侧工作流。 保持服务器上的秘密,单独的测试和生产访问,并将认证范围到最小的所需环境。

在批准的公共参考中不存在的直接REST终点、网页或验证行为,应被视为不可用,直到合作伙伴工程确认。

打开已批准的公共 API 参考

服装资产基线

  • JPEG 或 PNG; 2000 × 2,000 px 最低,大约 4K 偏好。
  • 每张照片一件衣服,以清洁的边缘和中立甚至照明为中心。
  • 前景要求;后景建议,当此体验被启用时。
  • 固定 SKU、风格或服装 ID 包含在文件名和目录记录中。
  • 没有手、挂着、风格的脚印、水标或与物品无关的服装阻止。
  • 变量地图检查之前允许体验。

QA 和启动

  • 在当前的移动和桌面浏览器上测试完整的客户行程。
  • 检查产品和变量地图,服装准备和车辆行为。
  • 检查键盘访问、焦点顺序、可用的名称和落后行为。
  • 测量产品页面性能之前和之后 SPREEAI.
  • 练习充电、空、不适用、时间出发和退出状态。
  • 确认同意语言和批准处理客户图像。
  • 获得工程,商业,QA和品牌签名之前生产。

故障排除

按钮不会出现

确认 SDK 启动、客户端和合作伙伴识别、目标选择器、产品可用性、服装准备和变量地图。 然后检查浏览器控制台和网络错误,而不共享代币。

出现错误的产品或变量

将商店前产品和变量ID与发送到 SPREEAI. 确认交付的请求在买家改变变量时发生变化。

体验是缓慢或不可用

测试已知的产品,验证活跃环境,检查被阻止的请求,并比较清洁的浏览器会议。 捕捉支持的时间表和可重复序列。

开发者支持

电子邮件 support@spreeai.com 与环境、产品或服装 ID、浏览器或 vic e、近期时间,预期的行为和生殖步骤。 不要包含秘密或客户图像。

选择你的语言。