Un trabajo de publicación. Instagram y X, programado, seguido y reintentado de forma segura.
POST /publishing/jobs crea el trabajo. Nosotros ejecutamos los pasos del proveedor y tú consultas el estado hasta published.
'/%3e%3cpath%20d='M23.3789%2048.0469C23.3789%2061.6797%2034.4336%2072.7148%2048.0469%2072.7148C61.6602%2072.7148%2072.7148%2061.6602%2072.7148%2048.0469C72.7148%2034.4336%2061.6797%2023.3789%2048.0469%2023.3789C34.4141%2023.3789%2023.3789%2034.4141%2023.3789%2048.0469ZM64.0625%2048.0469C64.0625%2056.8945%2056.8945%2064.0625%2048.0469%2064.0625C39.1992%2064.0625%2032.0313%2056.8945%2032.0313%2048.0469C32.0313%2039.1992%2039.1992%2032.0313%2048.0469%2032.0313C56.8945%2032.0313%2064.0625%2039.1992%2064.0625%2048.0469Z'%20fill='url(%23paint1_radial_3175_29)'/%3e%3cpath%20d='M73.7109%2028.1641C76.893%2028.1641%2079.4727%2025.5845%2079.4727%2022.4023C79.4727%2019.2202%2076.893%2016.6406%2073.7109%2016.6406C70.5288%2016.6406%2067.9492%2019.2202%2067.9492%2022.4023C67.9492%2025.5845%2070.5288%2028.1641%2073.7109%2028.1641Z'%20fill='%23654C9F'/%3e%3cdefs%3e%3cradialGradient%20id='paint0_radial_3175_29'%20cx='0'%20cy='0'%20r='1'%20gradientUnits='userSpaceOnUse'%20gradientTransform='translate(1.74843%2087.2782)%20rotate(-3.00009)%20scale(138.929%20118.088)'%3e%3cstop%20stop-color='%23FED576'/%3e%3cstop%20offset='0.2634'%20stop-color='%23F47133'/%3e%3cstop%20offset='0.6091'%20stop-color='%23BC3081'/%3e%3cstop%20offset='1'%20stop-color='%234C63D2'/%3e%3c/radialGradient%3e%3cradialGradient%20id='paint1_radial_3175_29'%20cx='0'%20cy='0'%20r='1'%20gradientUnits='userSpaceOnUse'%20gradientTransform='translate(24.2737%2068.1909)%20rotate(-3.00009)%20scale(71.3417%2060.6397)'%3e%3cstop%20stop-color='%23FED576'/%3e%3cstop%20offset='0.2634'%20stop-color='%23F47133'/%3e%3cstop%20offset='0.6091'%20stop-color='%23BC3081'/%3e%3cstop%20offset='1'%20stop-color='%234C63D2'/%3e%3c/radialGradient%3e%3c/defs%3e%3c/svg%3e){kind=small}
InstagramEjemplos ilustrativos de herramientas que puedes crear.
Programación.
Define requestedPublishAt y cancela cualquier trabajo antes de que se envíe.
Reintentos idempotentes.
Un clientRequestId hace seguros los reintentos: nunca un post duplicado.
Entregas por destino.
Un trabajo apunta a muchas cuentas, con un resultado de entrega por destino.
Fallos clasificados.
Cada fallo lleva una categoría, un código y qué hacer a continuación.
// endpoints
- POST /publishing/jobs
- GET /publishing/jobs
- GET /publishing/jobs/{id}
- POST /publishing/jobs/{id}/cancel
- POST /publishing/jobs/{id}/retry
// reglas por plataforma, validadas antes de enviar nada
- ● Instagram: imágenes, carruseles mixtos y vídeos. Los vídeos se publican como Reels.
- ● X: texto de hasta 280 caracteres, hasta 4 imágenes o un solo vídeo. Los carruseles son solo de imágenes.
- ● Los medios se pasan como URLs públicas en el trabajo. No hay endpoint de subida.
Lo que los desarrolladores preguntan primero.
¿Cómo funciona la subida de medios?
Tú alojas el archivo y pasas su URL pública en el trabajo de publicación. Un solo medio crea un post individual y varias imágenes crean un carrusel. Nosotros descargamos el medio, creamos el contenedor del proveedor, lo sondeamos y publicamos.
¿Puedo programar posts?
Sí. Define requestedPublishAt en el trabajo y se publicará a esa hora. Puedes listar los trabajos programados en cualquier momento y cancelar cualquier trabajo antes de que se envíe.
¿Qué pasa cuando falla una publicación?
Cada fallo se clasifica: una categoría, un código y una instrucción que te dice si es recuperable. Los trabajos recuperables pueden reintentarse hasta 5 veces, y un reintento nunca produce un post duplicado. Además te avisamos por email cuando un trabajo falla.
¿Cuáles son los límites?
Cada cuenta conectada puede publicar 100 posts por periodo de facturación. El endpoint de límites muestra en vivo el límite configurado, el uso actual y el margen restante, para que tu código lo compruebe antes de publicar.
