Um trabalho de publicação. Instagram e X, agendado, acompanhado e repetido com segurança.
POST /publishing/jobs cria o trabalho. Nós executamos os passos do provedor e você consulta o status até 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}
InstagramExemplos ilustrativos de ferramentas que você pode criar.
Agendamento.
Defina requestedPublishAt e cancele qualquer trabalho antes de ele ser enviado.
Novas tentativas idempotentes.
Um clientRequestId torna as novas tentativas seguras: nunca um post duplicado.
Entregas por destino.
Um trabalho aponta para várias contas, com um resultado de entrega por destino.
Falhas classificadas.
Cada falha traz uma categoria, um código e o que fazer em seguida.
// endpoints
- POST /publishing/jobs
- GET /publishing/jobs
- GET /publishing/jobs/{id}
- POST /publishing/jobs/{id}/cancel
- POST /publishing/jobs/{id}/retry
// regras por plataforma, validadas antes de enviar algo
- ● Instagram: imagens, carrosséis mistos e vídeos. Os vídeos são publicados como Reels.
- ● X: texto de até 280 caracteres, até 4 imagens ou um único vídeo. Os carrosséis são apenas de imagens.
- ● A mídia é passada como URLs públicas no trabalho. Não há endpoint de upload.
O que os desenvolvedores perguntam primeiro.
Como funciona o envio de mídia?
Você hospeda o arquivo e passa a URL pública dele no trabalho de publicação. Um item de mídia gera um post único, várias imagens geram um carrossel. Nós buscamos a mídia, criamos o container do provedor, consultamos e publicamos.
Posso agendar posts?
Sim. Defina requestedPublishAt no trabalho e ele é publicado nesse horário. Você pode listar os trabalhos agendados a qualquer momento e cancelar qualquer trabalho antes de ele ser enviado.
O que acontece quando uma publicação falha?
Cada falha é classificada: uma categoria, um código e uma instrução que indica se é recuperável. Os trabalhos recuperáveis podem ser repetidos até 5 vezes e uma nova tentativa nunca gera um post duplicado. Também enviamos um e-mail para você quando um trabalho falha.
Quais são os limites?
Cada conta conectada pode publicar 100 posts por período de cobrança. O endpoint de limites mostra o limite configurado, o uso atual e a cota restante em tempo real, para que seu código possa verificar antes de publicar.
