跳到主内容
版本: 1.x

API06003: 无效的站点配置

这意味着什么​

站点配置无效或不完整。这可能涉及错误的 URL、身份验证设置或其他配置问题。

常见原因​

  • 部分配置 — 某些设置缺失
  • 设置不匹配 — 配置与站点不匹配
  • 损坏的配置 — 设置已损坏
  • 站点更改 — 站点已被修改而未更新 POS 配置

如何修复​

1. 检查所有设置​

检查完整配置：

  • 站点 URL 正确
  • 身份验证配置正确
  • 任何附加设置均正确

2. 从头开始重新配置​

请先检查是否有未保存的工作

清除本地数据或重新安装应用会删除此设备上尚未同步到店铺的所有内容，包括离线期间完成的销售、未结购物车以及未保存的编辑。清除前，请打开 Store health → Database，确认没有记录显示为暂存或从未到达服务器；然后打开 Store health → Logs，确认 0 条记录卡住且 0 项更改等待发送；接着完成或记录每个未结购物车。如果您的 WCPOS 没有 Store health 页面，请先更新 WCPOS，再进行检查。如果存在任何记录或等待发送的内容，或者无法检查，请勿清除；请咨询店铺所有者或联系支持团队。

只有在配置损坏，并且完成上述检查后，才执行以下操作：

  1. 清除所有存储的设置
  2. 重新开始设置过程
  3. 输入新的配置

3. 检查站点要求​

验证您的 WordPress 站点满足要求：

  • WordPress 已安装并可访问
  • WooCommerce 已安装并处于活动状态
  • WCPOS 插件已安装并处于活动状态
  • 启用永久链接（不是“普通”）

4. 测试站点访问​

验证这些 URL 在浏览器中可用：

  • https://yoursite.com/ — 主站点
  • https://yoursite.com/wp-json/ — REST API
  • https://yoursite.com/wp-json/wcpos/v1/ — WCPOS API

5. 检查 WordPress 设置​

在 WordPress 管理后台：

  1. 设置 → 常规 — 验证 URL
  2. 设置 → 永久链接 — 确保不是“普通”
  3. WooCommerce → 状态 — 检查问题

配置要求​

有效的配置需要：

  • 站点 URL — 带协议的完整 URL
  • 身份验证 — 有效的凭据或 API 密钥
  • 权限 — 用户具有 POS 访问权限
  • 插件 — 所需插件处于活动状态