​

WordPress插件接入

​

概述

WordPress插件接入面向非电商类WordPress站点 — 例如企业官网、内容站、服务类网站。这些站点不使用WooCommerce，但仍然希望被AI代理发现和索引。 通过wordpressPluginRouter.ts实现，插件提供一键连接体验，自动完成商家账户创建和API密钥生成。

​

与WooCommerce插件的区别

WordPress插件的核心价值是让非电商站点也能接入AI代理商务生态 — 获得信任评分、被AI代理发现、声明站点能力。

​

API端点

​

一键连接流程

​

步骤1：安装WordPress插件

商家在WordPress后台安装ORBEXA插件，激活后在设置页面点击「连接ORBEXA」。

​

步骤2：一键握手

插件向/api/integrations/wordpress/connect端点发送连接请求。请求必须包含以下Header：

• X-Plugin-Platform — 标识平台类型（wordpress）
• X-Plugin-Version — 插件版本号

这两个Header是必需的，缺少任何一个都会被拒绝。

​

步骤3：自动创建资源

ORBEXA在收到连接请求后自动执行以下操作：

1. 创建商家账户 — 基于WordPress站点信息自动注册
2. 生成API密钥 — 为该商家创建专属API密钥
3. 链接OTR — 自动将商家域名关联到OTR信任评分系统

整个过程对商家完全透明，无需手动操作。

​

步骤4：连接确认

连接成功后，商家可通过/api/integrations/wordpress/status端点随时查询连接状态。

​

连接状态管理

​

查询状态

调用/api/integrations/wordpress/status可获取：

• 连接是否有效
• 商家ID
• API密钥状态
• OTR信任评分状态

​

断开连接

通过/api/integrations/wordpress/disconnect端点可安全断开连接，清理关联的商家数据和API密钥。

​

限速策略

WordPress插件接入的限速为 3次/分钟/IP。这是所有接入方式中最严格的限速，原因包括：

• WordPress插件通常在用户点击时触发，频率较低
• 防止恶意IP批量注册商家账户
• 保护自动创建流程的安全性

​

安全机制

​

必需Header验证

每个请求必须携带X-Plugin-Platform和X-Plugin-Version两个Header。这确保请求来自官方插件而非第三方脚本。

​

IP限速

严格的3次/分钟/IP限速，防止暴力注册。

​

自动OTR链接

连接完成后自动进入OTR信任评分流程，商家域名被纳入信任监控体系。

​

小结

WordPress插件为非电商站点提供了最简的接入方式：一键连接自动创建商家账户、API密钥和OTR信任链接。通过必需Header验证和严格IP限速保障安全。

---

下一章：API与数据库接入 — CSV导入、ETL管道、视觉爬取、瀑布式数据摄入