PostProxy API 技能
呼叫 PostProxy API 以在多個社群媒體平台(Facebook、Instagram、TikTok、LinkedIn、YouTube、X/Twitter、Threads)上管理社群媒體貼文。
設定
必須在環境變數 POSTPROXY_API_KEY 中設定 API 金鑰。
取得您的 API 金鑰:https://app.postproxy.dev/api_keys
基本 URL
https://api.postproxy.dev
驗證
所有請求都需要 Bearer token:
-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)
排程貼文
在貼文物件中加入 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": "連結在個人檔案中!" },
"youtube": { "title": "影片標題", "privacy_status": "public" },
"tiktok": { "privacy_status": "PUBLIC_TO_EVERYONE" }
}
}
使用者請求
$ARGUMENTS