Postproxy

¿Qué es Postproxy?

Postproxy es una API unificada de publicación en redes sociales que te permite publicar en múltiples redes sociales usando un único endpoint REST. En lugar de construir y mantener integraciones separadas por plataforma, te conectas una vez y envías un solo payload; Postproxy mapea tu contenido y medios a las reglas de cada plataforma seleccionada.

El propósito principal es proporcionar una capa de API estable para publicación, incluyendo manejo de conexiones, traducción de solicitudes a plataformas y resultados de publicación por plataforma.

Características principales

• Endpoint unificado de publicación (REST): Envía una sola solicitud (p. ej., POST /v1/publish o el POST /api/posts documentado) con un payload y “profiles” seleccionados, y Postproxy maneja la publicación en múltiples plataformas.
• Mapeo de resultados por plataforma: La API devuelve resultados por perfil de destino (p. ej., publicado, procesando, fallido), para que veas qué pasó en cada red.
• Gestión de conexiones a plataformas: Los flujos OAuth, almacenamiento de tokens y renovación automática se manejan por ti como parte del flujo de conexión a plataformas.
• Reintentos determinísticos e informes de estado: El sistema soporta reintentos y comportamiento consciente de límites de tasa/cuota, con informes claros de estado de publicación e intentos registrados.
• Conversión de formatos para entrega: El contenido se transforma para cumplir con los requisitos de cada plataforma (p. ej., cómo se adapta el mensaje/cuerpo para cada red).
• SDKs para lenguajes comunes: Se referencian SDKs oficiales para Node, Python, Ruby y otros lenguajes populares, reduciendo la necesidad de código personalizado para la API.
• Webhooks para eventos del ciclo de vida de publicación: Puedes crear un endpoint webhook (p. ej., con eventos como post.processed, platform_post.published y platform_post.failed) y recibir actualizaciones de Postproxy.

Cómo usar Postproxy

1. Comienza con la documentación de Postproxy y crea una solicitud API usando tu clave API (el sitio muestra Authorization: Bearer YOUR_API_KEY y ejemplos de payloads JSON).
2. Conecta las cuentas sociales a las que quieres publicar a través de las conexiones de plataformas de Postproxy (OAuth). Postproxy gestiona tokens y renovaciones.
3. Publica con una sola solicitud enviando el contenido de tu publicación más una lista de perfiles objetivo (plataformas) y URLs de medios opcionales.
4. Opcionalmente, suscríbete a eventos webhook para que tu aplicación sea notificada cuando finalice el procesamiento o cuando una publicación en plataforma tenga éxito o falle.

Los payloads de ejemplo en el sitio incluyen campos como:

• post.body (o content en algunos ejemplos de SDK)
• profiles (p. ej., "twitter", "linkedin", "threads")
• media (arreglo de URLs de medios)

Casos de uso

• Construye una sola acción “Publicar” en tu app: Un producto puede ofrecer a los usuarios un flujo de publicación único mientras Postproxy maneja el formateo, entrega y resultados por red para cada plataforma seleccionada.
• Reemplaza integraciones frágiles por plataforma: Los equipos pueden consolidar múltiples integraciones personalizadas en una sola llamada API, reduciendo el área afectada por cambios específicos de plataformas.
• Colas de publicación para agencias o múltiples clientes: Usa agrupación de perfiles y conceptos de programación/colas para mantener separadas las conexiones de diferentes clientes y gestionar publicaciones de alto volumen.
• Pipelines de automatización y publicaciones activadas por IA: Trata la publicación como un paso único en un flujo upstream (p. ej., activado por un nodo de automatización o un agente) mientras Postproxy maneja reintentos y estados.
• Publicación del lado del servidor para usuarios finales sin cuentas Postproxy: Proporciona un entorno con ámbito por cliente para que la publicación se ejecute bajo tu marca mientras los usuarios conectan cuentas a través de tu UI.

Preguntas frecuentes

• ¿Qué plataformas están soportadas? El sitio lista soporte para Instagram, TikTok, LinkedIn, X, YouTube, Facebook, Threads y Pinterest.

• ¿Puedo publicar en múltiples redes con una sola solicitud? Sí. Los ejemplos muestran un solo payload con profiles especificando las plataformas objetivo, y la API mapea el contenido a cada plataforma.

• ¿Necesito manejar la renovación de tokens OAuth yo mismo? No. El sitio indica que los flujos OAuth, almacenamiento de tokens y renovación automática se gestionan por ti.

• ¿Cómo sé si cada plataforma tuvo éxito? Postproxy proporciona resultados por plataforma (incluyendo estados fallidos y publicados) y soporta reintentos determinísticos con informes de estado explícitos.

• ¿Hay webhooks para eventos de publicación? Sí. El sitio incluye una solicitud de ejemplo para crear webhooks con eventos como post.processed, platform_post.published y platform_post.failed.

Alternativas

• Crear integraciones directas con las APIs oficiales de las plataformas: Esto puede ofrecer el máximo control, pero suele requerir mantener flujos OAuth separados, reglas de formato, manejo de límites de tasa y lógica de errores/reenvíos por plataforma.
• Usar una plataforma dedicada de gestión de redes sociales: Estas herramientas gestionan la publicación en redes mediante sus propios flujos de trabajo; intercambias el control personalizado de API por una configuración más rápida y una interfaz/proceso predefinido.
• Usar una herramienta genérica de automatización + programador con adaptadores por plataforma: Puedes orquestar los pasos de publicación en un pipeline, pero aún necesitas adaptadores/código de integración para cada red de destino.
• Usar un servicio iPaaS de integración con conectores sociales: Esto puede centralizar flujos de trabajo, pero la transformación de mensajes, políticas de reintento y detalles de resultados por plataforma dependen de los conectores y la configuración disponibles.