SwapFlow API

通过 REST API 以编程方式发布内容

REST API

使用 curl、脚本或您自己的工具发布到任何已连接的社交平台。

GET /api/cli/connections

列出您的社交账号

POST /api/cli/publish

发布内容到平台

POST /api/cli/posts

安排未来发布的帖子

GET /api/cli/posts

查看发布历史

GET /api/cli/posts/:id

获取帖子详情

PATCH /api/cli/posts/:id

更新已安排的帖子

获取你的 API 密钥

开始使用

只需两步：获取连接 ID，然后发布。文件直接上传 — 无需先上传到 SwapFlow。

# 1. 列出已连接的账号以获取连接 ID
curl -s "https://www.swapflow.top/api/cli/connections" \
  -H "X-API-Key: sf_your_api_key_here" | jq .

# 2. 直接发布文件 — 无需预先上传！
curl -X POST "https://www.swapflow.top/api/cli/publish" \
  -H "X-API-Key: sf_your_api_key_here" \
  -F "file=@photo.jpg" \
  -F "connectionId=YOUR_CONNECTION_ID" \
  -F "platform=twitter" \
  -F "caption=Posted from the API!"

在任何平台上安排未来发布的帖子。自动发布，精确度在5分钟以内。

# 安排未来发布的帖子
curl -X POST "https://www.swapflow.top/api/cli/posts" \
  -H "X-API-Key: sf_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "CONNECTION_ID",
    "caption": "Launching tomorrow!",
    "scheduledAt": "2026-04-01T15:30:00Z"
  }'

您也可以上传文件并设置平台特定选项：

# 安排未来发布的帖子
curl -X POST "https://www.swapflow.top/api/cli/posts" \
  -H "X-API-Key: sf_your_api_key_here" \
  -F "file=@video.mp4" \
  -F "connectionId=CONNECTION_ID" \
  -F "caption=Check this out!" \
  -F "scheduledAt=2026-04-01T15:30:00Z" \
  -F 'platformSettings={"youtube":{"privacyStatus":"public","videoType":"shorts"}}'

参数参考

参数	必需	描述
connectionId	Yes	目标社交连接的 UUID
platform	Yes	平台名称 (twitter, tiktok, youtube 等)
file	No	媒体文件 (multipart/form-data)
file1, file2, ...	No	多个图片文件用于轮播帖子 (multipart)
mediaId	No	来自 /api/media 的现有媒体 UUID
mediaIds	No	用于多图帖子的媒体 UUID JSON 数组
mediaUrl	No	媒体文件的直接 URL
caption	No	帖子文本或说明
mediaType	No	video、image 或 text（从文件自动检测）
tiktokUserConsent	TikTok	发布到 TikTok 时必须为 true
tiktokPrivacyLevel	No	SELF_ONLY、MUTUAL_FOLLOW_FRIENDS、FOLLOWER_OF_CREATOR 或 PUBLIC_TO_EVERYONE
youtubePrivacy	No	public、private 或 unlisted（默认：private）
youtubeIsShorts	No	true 为 Shorts，false 为长视频（默认：true）
pinterestBoardId	Pinterest	Pinterest 画板 ID（Pinterest 必需）
snapchatType	No	spotlight 或 stories（默认：spotlight）
scheduledAt	No	ISO 8601 格式的未来发布时间（至少提前5分钟）。省略则立即异步发布
webhookUrl	No	用于发布成功/失败状态回调的 HTTPS URL
platformSettings	No	平台特定选项的 JSON（如 TikTok 隐私设置、YouTube 类型）

支持的平台

twitter

tiktok

instagram standalone

facebook

youtube

threads

bluesky

snapchat

开始使用