HTTP API 推送与集成指南

SEONIB 支持通过 HTTP API 实现高度自定义的内容流转。您可以选择通过 API 访问 主动获取博客内容，或者利用 HTTP API 推送 功能让系统在内容生成后第一时间“告诉”您的服务器。

1. API 访问（主动获取内容）

如果您希望在自己的应用程序（如自建站、App 或自定义管理后台）中集成 SEONIB 生成的文章，可以使用我们的标准 API。

基础信息

• API 根地址：https://api.seonib.com/open/api/v1/
• 认证方式：请在 API 访问页面获取您的专属 API Key，并在请求头中带上 Content-Type: application/json。

核心端点

• 获取博客列表：GET /posts：列出所有已生成的博客文章。
• 获取单篇文章内容：GET /post/:slug：通过文章 ID 或 Slug 获取详细内容，包括正文、AI 配图及 SEO 元数据。

2. HTTP API 推送（自动分发内容）

当 AI 代理完成一篇新文章的创作后，SEONIB 可以通过 Webhook 的形式将数据推送到您指定的 URL。这对于需要实时更新内容的自动化流水线非常有效。

配置步骤

1. 登录 SEONIB 控制面板，进入 “集成管理” 页面。
2. 找到 “HTTP API 推送” 模块，点击 “配置”。
3. 在弹窗中填入以下信息：接口 URL：接收推送数据的服务器地址（必须以 https:// 开头）。签名密钥：用于验证请求合法性的密钥，请妥善保管。
4. 点击 “保存”。

推送机制

• 触发时机：AI 代理完成“内容生成”且状态变为“已完成”时触发。
• 数据格式：系统将以 POST 请求发送 JSON 格式的数据包，包含文章标题、正文 HTML、关键词、摘要及图片链接。

3. 常见问题 (FAQ)

Q：API 有调用频率限制吗？
A：没有限制。 我们鼓励开发者根据业务需求灵活调用 API，无论是实时抓取还是大规模同步，系统均能提供稳定支持。

Q：如何验证推送数据的安全性？
A：所有来自 SEONIB 的 HTTP 推送都会包含一个基于您“签名密钥”生成的签名头。 您的服务器应根据该密钥校验签名，以确保接收到的内容确实来自 SEONIB 且未被篡改。

Q：免费版用户可以使用 API 吗？
A：可以。 只要在后台开启 API 访问或配置 HTTP 推送，即可在额度范围内体验全自动化的内容流转。