API 与小组件

将 LiKE AI 搜索嵌入到您的应用程序、网站或内部系统中。三种集成方式：REST API、JS 小组件、iframe。

#REST API

按套餐提供。 公开 API 和公开小组件仅在包含它们的套餐上可用（见套餐与计费）。在其他套餐上无法创建密钥或公开小组件，已发放的也会停止响应：通过密钥的请求会收到 403，网站上不会出现小组件按钮。企业小组件不受此开关影响。

#步骤 1 — 创建 API 密钥

1. 集成 → Public API → “创建密钥”
2. 输入名称（例如“移动应用”）
3. 复制密钥 — 它仅显示一次

#步骤 2 — 使用 API

所有请求通过请求头授权：

X-API-Key: your-key

#核心端点

#示例：AI 搜索

curl -X POST https://your-account.lynkora.pro/api/public/search \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "Как оформить отпуск?"}'

响应：

{
  "answer": "Для оформления отпуска...",
  "sources": [
    {"title": "Политика отпусков", "url": "..."}
  ]
}

#速率限制

API 请求按密钥进行限流；超出时会返回 HTTP 429 并带有 Retry-After 请求头。

#安全

1. 将密钥存储在环境变量中，而非代码中
2. 为每个应用程序创建单独的密钥
3. 删除未使用的密钥
4. 在密钥设置中限制域名

#JS 小组件

一个浮动的 AI 搜索按钮，可嵌入任何网站。

#步骤 1 — 获取代码

1. 集成 → 渠道 → “JS Widget”卡片 → “管理小组件” → “创建小组件”。填写“放置小部件的网站地址”
2. 配置参数（见下表）
3. 复制代码

#步骤 2 — 添加到您的网站

将复制的 <script> 插入到 </body> 结束标签之前：

#在网站构建器中粘贴代码的位置

代码对所有网站都相同，无需修改：无论构建器把这行代码放在哪里，小组件都会自行在页面上找到位置。区别只在于粘贴到哪里。

任意网站（HTML）。 将代码粘贴到每个需要搜索的页面的 </body> 结束标签之前——或粘贴到网站的公共模板中。

WordPress。 安装 WPCode 插件（Insert Headers and Footers）→ Code Snippets → Header & Footer → 将代码粘贴到 Footer → Save Changes。在 WordPress.com 上，并非所有套餐都可以使用插件。

Tilda。 整个网站：Site Settings → More → HTML code for the HEAD section → 粘贴代码 → Save → 重新发布所有页面。单个页面：添加 Other → T123 (HTML code) 区块，并将代码粘贴到其中。

Wix。 在网站控制台中打开 Settings → Custom Code（视界面版本而定，位于“Advanced”或“Development & integrations”下）→ Add Custom Code → 粘贴代码 → All pages → Body — end → Apply。请勿在页面上使用“Embed HTML”元素：它会在另一个地址的框架中打开，小组件在那里无法工作。Wix 的自定义代码仅在已连接域名的高级套餐中可用。

Webflow。 Site settings → Custom code → Footer code → 粘贴代码 → Save → 发布网站。全站自定义代码仅在付费网站套餐中可用。

Squarespace。 打开 Code Injection（在网站设置中；视界面版本而定，位于 Developer tools 或 Website Tools 下）→ 将代码粘贴到 Footer → Save。并非所有套餐都提供代码注入。

Shopify。 Online Store → Themes → … → Edit code → layout/theme.liquid 文件 → 将代码粘贴到 </body> 之前 → Save。

Framer。 Site Settings → General → Custom Code → 将代码粘贴到 End of tag → 发布网站。

Google Tag Manager。 Tags → New → Custom HTML → 粘贴代码 → 触发器 All Pages → Save → Publish 容器。

Docusaurus。 代码写在 docusaurus.config.js 中，使用同一个密钥：

scripts: [
  {
    src: 'https://your-account.lynkora.pro/api/public/widget.js',
    'data-key': 'wk_live_YOUR_KEY',
    async: true,
  },
],

网站地址。 小组件仅在 允许的来源 中列出的地址上工作，且地址须完全匹配：example.com 和 www.example.com 是两个不同的地址——请两者都添加。如果您在构建器的预览地址上测试网站（例如 *.tilda.ws、*.wixsite.com、*.webflow.io、*.myshopify.com），也请将其添加。

按钮没有出现？ 请检查三点：小组件已启用；页面地址已列入 允许的来源——须完全一致，注意是否带 www；代码位于网站设置或模板中，而不是构建器在框架中打开的元素里。

#小组件参数

#效果

您网站的角落会出现一个按钮（颜色取自小组件设置）。点击 → 带提问框的聊天窗口 → 来自您知识库的 AI 回答。

#语言

访客可通过窗口标题栏中的地球图标按钮更改语言；该选择会针对此小组件保存在其浏览器中。未作选择时，小组件会采用浏览器语言中第一个匹配的语言，其次是小组件设置中的语言（data-lang），最后是英语。不考虑您网站页面的语言。阿拉伯语下窗口按从右到左显示。

#绑定网站

小组件仅在创建时填写的地址上工作（“放置小部件的网站地址”）；来自其他网站的请求会被拒绝。多个地址用逗号分隔。没有地址无法启用小组件，不接受表示“任意网站”的星号。地址按精确匹配比较：example.com 和 www.example.com 是不同的地址，如果网站可通过两者访问，请同时填写。本地测试时请填写带端口的地址，例如 http://127.0.0.1:8899。

#访客看到的内容

• 回答文本中没有 [2.3] 这类来源标记；标题和链接均已排版。
• 回答下方是“来源”区块：链接指向原始页面，若没有原始页面则指向文章。
• 只有企业小组件才有“打开完整搜索”链接。

#如果 AI 回答额度已用尽

在额度恢复之前，公开小组件会在网站上完全隐藏。企业小组件仍保留在原处，但不接受提问，并显示搜索何时恢复可用。

#iframe

嵌入到您页面上的功能完整的搜索界面：

#嵌入代码

/embed 是唯一允许在其他网站的框架中打开的门户地址。 门户根地址（https://your-account.lynkora.pro）无法嵌入，浏览器会拒绝。框架不需要密钥：它以匿名方式运行，显示的内容与匿名门户访客看到的完全一致；其范围来自小部件设置。

#直接链接

如果 iframe 不适合您，请为用户提供直接链接：https://your-account.lynkora.pro

#演示模式

为便于在没有 API 密钥的情况下测试，提供了一个带限制的演示端点：

端点：POST /api/public/demo/search

#身份验证模式对比

小组件支持两种身份验证模式。

#模式 A — 信任 URL 区域

客户端身份验证：由您负责谁能到达带小组件的页面（VPN、SSO、受保护路由）。Lynkora 不知道用户的身份 — 仅知道请求的 Origin/IP。小组件对所有打开带嵌入代码页面的人可见。

• 后端代码：0 行
• 接入时间：约 2 分钟
• 适用于：内网、内部门户

#模式 B — 会话令牌（按用户 JWT）

您的后端为每个用户签发短期会话令牌。Lynkora 知道身份，按用户保留审计，并支持吊销和 GDPR DSAR。

• 后端代码：约 10 行（通过 SDK）
• 接入时间：1–2 小时
• 适用于：多租户 SaaS、受监管行业