> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ORBEXA WordPress插件一键接入

> WordPress插件一键接入ORBEXA详细操作指南：面向非电商类WordPress站点的快速连接方案，安装插件后自动完成商家账户创建与API密钥生成、配置OTR信任链接并同步站点元数据信息，让企业官网和内容站也能获得AI信任评分并被ChatGPT等AI代理发现和索引

# WordPress插件接入

## 概述

WordPress插件接入面向**非电商类WordPress站点** -- 例如企业官网、内容站、服务类网站。这些站点不使用WooCommerce，但仍然希望被AI代理发现和索引。

插件提供一键连接体验，自动完成商家账户创建和API密钥生成。

## 与WooCommerce插件的区别

| 特性   | WordPress插件          | WooCommerce插件   |
| ---- | -------------------- | --------------- |
| 目标用户 | 非电商WordPress站点       | WooCommerce电商站点 |
| 核心功能 | 站点身份注册、OTR信任链接       | 商品/订单/库存同步      |
| 自动创建 | 商家账户 + API密钥 + OTR链接 | 数据同步通道          |
| 数据同步 | 站点元信息                | 完整商品目录          |

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

## API端点

| 端点                                       | 方法   | 功能        |
| ---------------------------------------- | ---- | --------- |
| `/api/integrations/wordpress/connect`    | POST | 一键连接，完成握手 |
| `/api/integrations/wordpress/status`     | POST | 查询连接状态    |
| `/api/integrations/wordpress/disconnect` | POST | 断开连接      |

## 一键连接流程

### 步骤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与数据库接入](/zh/book-7/ch5-api) -- CSV导入、ETL管道、视觉爬取、瀑布式数据摄入