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로 만들어졌어요.

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에서 작성한 게시물이 사이트에 올라가게 해요. 다른 언어라면 API에서 실시간으로 제공되는 OpenAPI 스펙에 생성기를 연결해 현재 배포된 것과 일치하는 클라이언트를 받으세요.

개발 시작하기
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 라이선스이며 npm에 @fopost/sdk로 게시되어 있어요. MCP 서버인 @fopost/mcp도 MIT예요.

SDK는 브라우저에서 작동하나요?

fetch가 있는 곳이라면 어디서든 실행되지만, API 키는 서버 시크릿이에요. 클라이언트 측 코드가 아니라 서버, 엣지 함수, CLI에서 호출하세요.

WordPress 플러그인은 호스팅 서비스를 사용하나요?

네. 자체 호스팅 사이트용 커넥터예요. 플러그인에서 사이트 토큰을 생성해 FoPost에 붙여 넣으면, 그곳에서 작성한 게시물이 사이트에 만들어져요. 마찬가지로 플러그인 디렉터리에 있는 WooCommerce용 FoPost는 상품이 출시되거나, 할인에 들어가거나, 재입고될 때 게시해요.

다른 언어용 클라이언트는 어떻게 받나요?

API에서 OpenAPI 스펙을 내려받아 사용하는 언어의 생성기로 실행하세요. 스펙은 API와 함께 버전이 관리되므로 업그레이드할 때마다 다시 생성하세요.

오늘 바로 SDK로 개발하세요

무료로 시작할 수 있고 전체 API가 포함돼요. 키를 만들고 몇 분 만에 첫 호출을 해 보세요.

API 키 받기