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"]
}'
게시물 생성 (파일 업로드)
멀티파트 폼 데이터를 사용하여 로컬 파일 업로드:
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": "링크는 프로필에 있습니다!" },
"youtube": { "title": "동영상 제목", "privacy_status": "public" },
"tiktok": { "privacy_status": "PUBLIC_TO_EVERYONE" }
}
}
사용자 요청
$ARGUMENTS