Postproxy

Postproxy란?

Postproxy는 단일 REST 엔드포인트를 사용하여 여러 소셜 네트워크에 게시할 수 있는 통합 소셜 미디어 게시 API입니다. 플랫폼별 별도 통합을 구축하고 유지하는 대신 한 번 연결하고 하나의 페이로드를 전송하면 Postproxy가 콘텐츠와 미디어를 선택된 각 플랫폼의 규칙에 매핑합니다.

핵심 목적은 연결 처리, 플랫폼 요청 번역, 플랫폼별 게시 결과를 포함한 안정적인 게시 API 레이어를 제공하는 것입니다.

주요 기능

• 통합 게시 엔드포인트 (REST): 단일 요청(예: POST /v1/publish 또는 문서화된 POST /api/posts)에 하나의 페이로드와 선택된 “profiles”를 보내고 Postproxy가 여러 플랫폼 간 게시를 처리합니다.
• 플랫폼별 결과 매핑: API가 대상 프로필(예: 게시됨, 처리 중, 실패)별 결과를 반환하여 각 네트워크의 결과를 확인할 수 있습니다.
• 플랫폼 연결 관리: OAuth 흐름, 토큰 저장, 자동 새로고침이 플랫폼 연결 워크플로의 일부로 처리됩니다.
• 결정적 재시도 및 상태 보고: 시스템이 재시도와 속도 제한/할당량 인식 동작을 지원하며, 명확한 게시 상태 보고와 기록된 시도를 제공합니다.
• 전달을 위한 형식 변환: 콘텐츠가 각 플랫폼 요구사항에 맞게 변환됩니다(예: 메시지/본문이 각 네트워크에 적응되는 방식).
• 일반 언어용 SDK: Node, Python, Ruby 및 기타 인기 언어에 대한 공식 SDK를 참조하여 사용자 정의 API 배관을 줄입니다.
• 게시 수명 주기 이벤트용 웹훅: post.processed, platform_post.published, platform_post.failed 등의 이벤트를 가진 웹훅 엔드포인트를 생성하고 Postproxy로부터 업데이트를 받을 수 있습니다.

Postproxy 사용 방법

1. Postproxy 문서부터 시작하여 API 키를 사용한 API 요청을 생성하세요(사이트에 Authorization: Bearer YOUR_API_KEY와 JSON 페이로드 예제가 표시됩니다).
2. Postproxy의 플랫폼 연결(OAuth)을 통해 게시할 소셜 계정을 연결하세요. Postproxy가 토큰과 새로고침을 관리합니다.
3. 게시 콘텐츠와 대상 프로필(플랫폼) 목록, 선택적 미디어 URL을 하나의 요청으로 보내 게시하세요.
4. 선택적으로 웹훅 이벤트에 구독하여 처리 완료나 플랫폼 게시 성공/실패 시 애플리케이션이 알림을 받도록 하세요.

사이트에 표시된 예제 페이로드에는 다음 필드가 포함됩니다:

• post.body (일부 SDK 예제에서는 content)
• profiles (예: "twitter", "linkedin", "threads")
• media (미디어 URL 배열)

사용 사례

• 앱에 단일 “Publish” 작업 구축: 제품이 사용자에게 하나의 게시 흐름을 제공하는 동안 Postproxy가 선택된 각 플랫폼의 형식화, 전달, 결과를 처리합니다.
• 취약한 플랫폼별 통합 교체: 팀이 여러 사용자 정의 통합을 하나의 API 호출로 통합하여 플랫폼별 변경에 영향을 받는 영역을 줄입니다.
• 에이전시 또는 다중 클라이언트 게시 큐: 프로필 그룹화와 스케줄링/큐잉 개념을 사용하여 다른 클라이언트의 연결을 분리하고 대량 게시를 관리합니다.
• 자동화 파이프라인 및 AI 트리거 게시: 상위 워크플로(예: 자동화 노드나 에이전트에 의해 트리거)의 단일 단계로 게시를 처리하며 Postproxy가 재시도와 상태를 담당합니다.
• Postproxy 계정이 없는 최종 사용자용 서버 측 게시: 고객별 범위 제한 환경을 프로비저닝하여 사용자가 UI를 통해 계정을 연결하는 동안 브랜드 하에 게시가 실행됩니다.

자주 묻는 질문

• 지원 플랫폼은? 사이트에 Instagram, TikTok, LinkedIn, X, YouTube, Facebook, Threads, Pinterest 지원이 나열되어 있습니다.

• 하나의 요청으로 여러 네트워크에 게시할 수 있나요? 네. 예제에서 profiles로 대상 플랫폼을 지정한 단일 페이로드를 보여주며 API가 콘텐츠를 각 플랫폼에 매핑합니다.

• OAuth 토큰 새로고침을 직접 처리해야 하나요? 아니요. 사이트에 OAuth 흐름, 토큰 저장, 자동 새로고침이 관리된다고 명시되어 있습니다.

• 각 플랫폼이 성공했는지 어떻게 알 수 있나요? Postproxy가 플랫폼별 결과(실패 및 게시 상태 포함)를 제공하며 명시적 상태 보고와 결정적 재시도를 지원합니다.

• 게시 이벤트용 웹훅이 있나요? 네. 사이트에 post.processed, platform_post.published, platform_post.failed 등의 이벤트를 가진 웹훅 생성 요청 예제가 포함되어 있습니다.

대안

• 공식 플랫폼 API와 직접 통합 구축: 최대 제어를 제공할 수 있지만, 플랫폼별로 별도의 OAuth 흐름, 포맷팅 규칙, 속도 제한 처리, 오류/재시도 로직을 유지해야 합니다.
• 전용 소셜 미디어 관리 플랫폼 사용: 이러한 도구는 자체 워크플로를 통해 네트워크 간 게시를 처리합니다; 사용자 지정 API 제어를 더 빠른 설정과 의견 중심 UI/프로세스와 교환합니다.
• 플랫폼별 어댑터가 있는 범용 자동화 + 스케줄러 사용: 파이프라인에서 게시 단계를 조율할 수 있지만, 각 대상 네트워크에 대한 어댑터/통합 코드가 여전히 필요합니다.
• 소셜 커넥터가 있는 iPaaS/통합 서비스 사용: 워크플로를 중앙화할 수 있지만, 메시지 변환, 재시도 정책, 플랫폼별 결과 세부 사항은 사용 가능한 커넥터와 구성에 따라 다릅니다.