SDKAPI

选择适合你技术栈的包

TypeScript SDK 以完整类型封装托管的 FoPost API。PHP 核心库和 Laravel 封装采用 MIT 许可,使用你自己的平台凭据,直接从你的服务器发布。WordPress 插件把自托管站点连接到你的工作区。其他情况都可以从 OpenAPI 规范生成。

npm install @fopost/sdk
import { FoPost } from '@fopost/sdk';

const client = new FoPost({ apiKey: process.env.FOPOST_API_KEY });

const [workspace] = await client.workspaces.list();
const accounts = await client.accounts.list({ workspaceId: workspace.id });

const post = await client.posts.create({
  workspaceId: workspace.id,
  status: 'scheduled',
  scheduleAt: '2026-09-01T09:00:00Z',
  content: [{ text: 'Shipped a new release today.' }],
  accounts: accounts.map((a) => ({ id: a.id })),
});

TypeScript,完整类型

每个端点、请求体和响应都有类型。看文档的事交给自动补全。

无需账号的 PHP

核心库和 Laravel 包运行在你的服务器上,不需要托管账号。

OpenAPI 规范

由 API 本身提供,生成的客户端永远不会与生产环境脱节。

TypeScript

整个 API,都是类型化方法

@fopost/sdk 覆盖帖子、投递、账号、工作区、标签,以及 AI 文案、改写和二次利用辅助功能。它可在 Node 和边缘运行时中运行,会重试临时错误,并暴露速率限制响应头,方便你退避。MCP 服务器就基于它构建。

阅读 SDK 文档
投递与账号健康状况
const deliveries = await client.posts.deliveries(post.id);
for (const d of deliveries) {
  console.log(d.platform, d.status, d.external_url);
}

const health = await client.accounts.health(accounts[0].id);
console.log(health);

覆盖每种资源

一个客户端对象,每个端点一个方法,端到端类型化。

重试与退避

网络抖动和 429 会先重试,之后错误才会传到你这里。

与 MCP 同一内核

@fopost/mcp 使用这个 SDK,因此智能体和脚本的行为完全一致。

PHP

用你自己的凭据从 PHP 发布

fopost/social-core 是一个独立的发布库,每个网络一个适配器,零框架依赖。fopost/social-laravel 增加了服务提供者、门面、事件和队列支持。两者都不与托管产品通信;你提供平台凭据,它直接发帖。

查看 PHP 包
composer require fopost/social-laravel
use Fopost\Social\Laravel\Facades\FopostSocial;

$result = FopostSocial::linkedin('Shipped a new release today.');

if ($result->success) {
    logger()->info("Published: {$result->externalUrl}");
}

MIT 许可,跑在你的服务器上

Composer 安装,无需账号、无需密钥,我们也不设使用限制。

Laravel 集成

配置、门面、事件和队列发布,开箱即用。

相同的格式规则

长度限制和媒体处理与托管版适配器一致。

WordPress 及其他

WordPress 用插件,其他用规范

WordPress 插件通过一个限定权限的站点令牌,把自托管站点连接到你的工作区,你在 FoPost 中撰写的帖子就会发布到站点上。对于其他任何语言,OpenAPI 规范由 API 实时提供;用生成器读取它,就能得到与当前部署版本一致的客户端。

开始构建
OpenAPI
curl https://api.fopost.com/v1/openapi.json -o openapi.json

npx @openapitools/openapi-generator-cli generate \
  -i openapi.json -g python -o ./client

WordPress 插件

在插件目录中免费提供。粘贴站点令牌,即可发布到你的站点。

实时规范

GET /v1/openapi.json 始终描述正在运行的 API。

任何语言

Python、Go、Ruby,或任何有 OpenAPI 生成器的语言。

关于 SDK 的常见问题解答

哪些包需要账号?

TypeScript SDK 和 MCP 服务器与托管 API 通信,因此需要 FoPost 账号和 API 密钥。PHP 核心库、Laravel 包和 WordPress 插件都不需要。

PHP 包和 TypeScript SDK 有什么区别?

SDK 是 FoPost API 的客户端:你会获得排期、队列、重试、数据分析以及所有已连接账号。PHP 包是一个独立库,使用你提供的凭据直接发布到各个网络,不涉及任何托管服务。

TypeScript SDK 开源吗?

开源。它采用 MIT 许可,以 @fopost/sdk 发布在 npm 上。MCP 服务器 @fopost/mcp 同样采用 MIT 许可。

SDK 能在浏览器中使用吗?

只要有 fetch 的地方它都能运行,但 API 密钥是服务器端的机密。请从服务器、边缘函数或 CLI 调用,绝不要在客户端代码中调用。

WordPress 插件使用托管服务吗?

是的。它是自托管站点的连接器:你在插件中生成站点令牌,粘贴到 FoPost 中,你在那里撰写的帖子就会在你的站点上创建。同样在插件目录中的 FoPost for WooCommerce,会在商品上架、开始促销或恢复库存时自动发帖。

如何获取其他语言的客户端?

从 API 下载 OpenAPI 规范,用你所用语言的生成器处理即可。规范随 API 一起版本化,每次升级时重新生成。

今天就基于 SDK 开始构建

免费开始,包含完整 API。创建密钥,几分钟内完成第一次调用。

获取 API 密钥