SDKAPI

Chọn gói phù hợp với stack của bạn

SDK TypeScript bọc API FoPost được lưu trữ sẵn với đầy đủ kiểu dữ liệu. Lõi PHP và wrapper Laravel dùng giấy phép MIT và đăng thẳng từ máy chủ của bạn bằng thông tin xác thực nền tảng của chính bạn. Plugin WordPress kết nối trang tự lưu trữ với không gian làm việc của bạn. Mọi thứ khác đều tạo được từ bản đặc tả 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, đầy đủ kiểu dữ liệu

Mọi endpoint, nội dung yêu cầu và phản hồi đều có kiểu. Tính năng tự hoàn thành sẽ đọc giúp bạn.

PHP không cần tài khoản

Gói lõi và gói Laravel chạy trên máy chủ của bạn, không cần tài khoản dịch vụ lưu trữ.

Bản đặc tả OpenAPI

Được cung cấp từ chính API, nên client được tạo ra không bao giờ lệch khỏi production.

TypeScript

Toàn bộ API dưới dạng phương thức có kiểu

@fopost/sdk bao gồm bài đăng, lượt gửi, tài khoản, không gian làm việc, nhãn, cùng các công cụ AI tạo chú thích, viết lại và tái sử dụng nội dung. Nó chạy trên Node và edge runtime, tự thử lại khi gặp lỗi tạm thời, và hiển thị header giới hạn tần suất để bạn giảm tốc. Máy chủ MCP được xây dựng trên nó.

Đọc tài liệu SDK
Lượt gửi và tình trạng tài khoản
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);

Mọi tài nguyên

Một đối tượng client, mỗi endpoint một phương thức, có kiểu từ đầu đến cuối.

Thử lại và backoff

Trục trặc mạng và lỗi 429 được thử lại trước khi lỗi đến tay bạn.

Chung lõi với MCP

@fopost/mcp dùng SDK này, nên agent và script hoạt động giống hệt nhau.

PHP

Đăng bài từ PHP bằng thông tin xác thực của bạn

fopost/social-core là thư viện đăng bài độc lập với một adapter cho mỗi mạng và không phụ thuộc framework nào. fopost/social-laravel bổ sung service provider, facade, sự kiện và hỗ trợ hàng đợi. Cả hai đều không kết nối với sản phẩm lưu trữ sẵn; bạn tự cung cấp thông tin xác thực nền tảng và nó đăng trực tiếp.

Xem các gói 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, trên máy chủ của bạn

Cài bằng Composer, không tài khoản, không khóa, không giới hạn sử dụng nào từ chúng tôi.

Tích hợp Laravel

Cấu hình, facade, sự kiện và đăng bài qua hàng đợi có sẵn ngay.

Cùng quy tắc định dạng

Giới hạn độ dài và cách xử lý phương tiện khớp với các adapter của dịch vụ lưu trữ sẵn.

WordPress và mọi thứ khác

Plugin cho WordPress, bản đặc tả cho phần còn lại

Plugin WordPress kết nối trang tự lưu trữ với không gian làm việc của bạn bằng site token có phạm vi, nên bài bạn soạn trong FoPost sẽ xuất hiện trên trang. Với mọi ngôn ngữ khác, bản đặc tả OpenAPI được cung cấp trực tiếp từ API; trỏ một trình tạo mã vào đó và nhận client khớp với phiên bản đang chạy hôm nay.

Bắt đầu xây dựng
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

Plugin WordPress

Miễn phí trong thư mục plugin. Dán site token và đăng lên trang của bạn.

Bản đặc tả trực tiếp

GET /v1/openapi.json luôn mô tả đúng API đang chạy.

Mọi ngôn ngữ

Python, Go, Ruby hoặc bất kỳ ngôn ngữ nào có trình tạo OpenAPI.

Giải đáp câu hỏi về SDK

Những gói nào cần tài khoản?

SDK TypeScript và máy chủ MCP kết nối với API lưu trữ sẵn, nên cần tài khoản FoPost và khóa API. Lõi PHP, gói Laravel và plugin WordPress không cần cả hai.

Gói PHP khác SDK TypeScript ở điểm nào?

SDK là client cho API FoPost: bạn có lên lịch, hàng đợi, thử lại, phân tích và mọi tài khoản đã kết nối. Gói PHP là thư viện độc lập đăng trực tiếp lên từng mạng bằng thông tin xác thực bạn cung cấp, không liên quan đến dịch vụ lưu trữ sẵn nào.

SDK TypeScript có mã nguồn mở không?

Có. Nó dùng giấy phép MIT và được phát hành trên npm với tên @fopost/sdk. Máy chủ MCP, @fopost/mcp, cũng dùng MIT.

SDK có chạy trên trình duyệt không?

Nó chạy ở bất cứ đâu có fetch, nhưng khóa API là bí mật phía máy chủ. Hãy gọi từ máy chủ, edge function hoặc CLI, không bao giờ từ code phía client.

Plugin WordPress có dùng dịch vụ lưu trữ sẵn không?

Có. Đây là bộ kết nối cho trang tự lưu trữ: bạn tạo site token trong plugin, dán vào FoPost, và bài bạn soạn ở đó sẽ được tạo trên trang của bạn. FoPost cho WooCommerce, cũng có trong thư mục plugin, đăng sản phẩm khi chúng lên kệ, giảm giá hoặc có hàng trở lại.

Làm sao để có client cho ngôn ngữ khác?

Tải bản đặc tả OpenAPI từ API và chạy qua trình tạo cho ngôn ngữ của bạn. Bản đặc tả được đánh phiên bản cùng API, nên hãy tạo lại mỗi khi bạn nâng cấp.

Xây dựng trên SDK ngay hôm nay

Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.

Lấy khóa API