PostProxy API 技能
调用 PostProxy API 在多个平台(Facebook、Instagram、TikTok、LinkedIn、YouTube、X/Twitter、Threads)上管理社交媒体帖子。
设置
API 密钥必须设置在环境变量 POSTPROXY_API_KEY 中。
在此获取你的 API 密钥:https://app.postproxy.dev/api_keys
基础 URL
https://api.postproxy.dev
身份验证
所有请求都需要 Bearer 令牌:
-H "Authorization: Bearer $POSTPROXY_API_KEY"
端点
列出配置文件
curl -X GET "https://api.postproxy.dev/api/profiles" \
-H "Authorization: Bearer $POSTPROXY_API_KEY"
列出帖子
curl -X GET "https://api.postproxy.dev/api/posts" \
-H "Authorization: Bearer $POSTPROXY_API_KEY"
获取帖子
curl -X GET "https://api.postproxy.dev/api/posts/{id}" \
-H "Authorization: Bearer $POSTPROXY_API_KEY"
创建帖子(JSON + 媒体 URL)
curl -X POST "https://api.postproxy.dev/api/posts" \
-H "Authorization: Bearer $POSTPROXY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": {
"body": "帖子内容"
},
"profiles": ["twitter", "linkedin", "threads"],
"media": ["https://example.com/image.jpg"]
}'
创建帖子(文件上传)
使用 multipart/form-data 上传本地文件:
curl -X POST "https://api.postproxy.dev/api/posts" \
-H "Authorization: Bearer $POSTPROXY_API_KEY" \
-F "post[body]=看看这个图片!" \
-F "profiles[]=instagram" \
-F "profiles[]=twitter" \
-F "media[]=@/path/to/image.jpg" \
-F "media[]=@/path/to/image2.png"
创建草稿
添加 post[draft]=true 以创建而不发布:
curl -X POST "https://api.postproxy.dev/api/posts" \
-H "Authorization: Bearer $POSTPROXY_API_KEY" \
-F "post[body]=草稿内容" \
-F "profiles[]=twitter" \
-F "media[]=@/path/to/image.jpg" \
-F "post[draft]=true"
发布草稿
curl -X POST "https://api.postproxy.dev/api/posts/{id}/publish" \
-H "Authorization: Bearer $POSTPROXY_API_KEY"
可用的配置文件选项:facebook、instagram、tiktok、linkedin、youtube、twitter、threads(或使用配置文件 ID)
定时发布帖子
在 post 对象中添加 scheduled_at:
curl -X POST "https://api.postproxy.dev/api/posts" \
-H "Authorization: Bearer $POSTPROXY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": {
"body": "定时发布的帖子",
"scheduled_at": "2024-01-16T09:00:00Z"
},
"profiles": ["twitter"]
}'
删除帖子
curl -X DELETE "https://api.postproxy.dev/api/posts/{id}" \
-H "Authorization: Bearer $POSTPROXY_API_KEY"
平台特定参数
对于 Instagram、TikTok、YouTube,添加 platforms 对象:
{
"platforms": {
"instagram": { "format": "reel", "first_comment": "Link in bio!" },
"youtube": { "title": "视频标题", "privacy_status": "public" },
"tiktok": { "privacy_status": "PUBLIC_TO_EVERYONE" }
}
}
用户请求
$ARGUMENTS