开发者
在此构建，基于 Mateflow API。
基于 Mateflow 开放 API 构建：作用域化的 API 密钥、统一的 JSON POST 端点与 Webhooks，让社区与你的工具栈互通。
能力
集成所需的一切
API key 认证
在社区管理后台创建带作用域的 API 密钥，所有请求通过 X-API-Key 请求头认证。
REST API
通过一致的 JSON API 读写社区数据。所有端点位于 /site_open_api/v1 下，统一使用 POST 方法与 JSON 请求体。
Webhooks
配置 webhook 端点，可实时接收成员注册、付款、内容变更等事件通知。
集成
通过集成中心连接第三方工具。内置对常见工作流的支持，并提供应用目录以扩展功能。
SSO（SAML 与 OIDC）
基于 SAML 2.0 和 OpenID Connect 的企业级 SSO。集中管理团队和社区成员的认证。
Webhook 日志与监控
为每个 webhook 事件提供完整的投递日志。可调试失败的投递、检查 payload 并监控集成的健康状况。
开放 API 端点
所有端点位于 https://api.mateflow.com/site_open_api/v1 下，使用 POST 方法与 JSON 请求体，并需要具备对应作用域的 API 密钥。
BASE URLhttps://api.mateflow.com/site_open_api/v1
- POST/site/getsite.read获取站点信息
- POST/feed/listcontent.read获取信息流列表
- POST/post/searchcontent.read搜索帖子
- POST/post/createcontent.write创建帖子
- POST/media/get_tokenmedia.write获取媒体上传令牌
快速开始
三步即可上手
步骤 01
创建账户
免费注册，并在 Creator Dashboard 中创建你的第一个社区站点。
步骤 02
生成 API keys
在社区管理后台（设置 → 集成）启用 API 访问并创建带作用域的密钥。Growth、Business 及以上套餐可用。
步骤 03
发起首次调用
使用 X-API-Key 请求头发送你的第一个请求。所有端点均接受 JSON POST 请求。
开始调用 API
常用语言的快速示例。将 sk_live_xxx 替换为你在管理后台创建的真实密钥。
cURL
curl -X POST \
https://api.mateflow.com/site_open_api/v1/post/search \
-H "X-API-Key: sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"keyword": "hello", "limit": 20}'JavaScript
const res = await fetch(
"https://api.mateflow.com/site_open_api/v1/post/create",
{
method: "POST",
headers: {
"X-API-Key": "sk_live_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ title: "Hello", content: "From the API!" }),
}
);
const data = await res.json();Python
import requests
res = requests.post(
"https://api.mateflow.com/site_open_api/v1/site/get",
headers={"X-API-Key": "sk_live_xxx"},
json={},
)
data = res.json()SDK 路线图
面向 Node.js、Python 和 Go 的官方 SDK 已列入路线图。在此之前，REST API 可与任何 HTTP 客户端配合使用。完整的 API 文档即将推出。