API 与小组件

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

#REST API

#步骤 1 — 创建 API 密钥

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

#步骤 2 — 使用 API

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

X-API-Key: your-key

#核心端点

#示例：AI 搜索

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

响应：

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

#速率限制

API 请求按密钥进行限流。具体限额取决于您的套餐；超出时会返回 HTTP 429 并带有 Retry-After 请求头。您套餐的确切数值见套餐部分。

#安全

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

#JS 小组件

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

#步骤 1 — 获取代码

1. 集成 → JS Widget
2. 配置参数（见下表）
3. 复制代码

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

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

#小组件参数

#效果

您网站的角落会出现一个紫色按钮。点击 → 带搜索栏的模态窗口 → 来自您知识库的 AI 回答。

#iframe

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

#嵌入代码

#直接链接

如果 iframe 不适合您，请为用户提供直接链接：https://amedia.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、受监管行业