Criar publicações em lote

Cria várias publicações em redes sociais em uma única requisição. As linhas são enviadas no corpo da requisição — não há upload de arquivo nem CSV, apenas um array dos mesmos objetos que POST /social/posts aceita um de cada vez. Até 500 linhas por requisição.

Caso de uso: carregar o conteúdo de um trimestre em uma única chamada. Sua ferramenta de planejamento tem todo o calendário de conteúdo do cliente. Crie uma linha para cada horário previsto, identifique cada uma com seu próprio clientReference e envie todas juntas. O lote é aceito por inteiro ou informa exatamente quais linhas você precisa corrigir. Armazene o job.id retornado e consulte GET /social/bulk-posts/{bulkJobId} periodicamente até que status esteja em um estado terminal; depois, concilie cada resultado pelo respectivo clientReference.

Todo o lote é validado previamente

A validação é executada em todas as linhas antes que qualquer coisa seja criada, e o lote é atômico nessa etapa:

• Se qualquer linha for inválida, nada será criado. success é false, SY95050 é retornado em error, e cada linha inválida aparece em job.results[] com seu index com base em 0, seu clientReference e o motivo em errors[]. Corrija essas linhas e reenvie todo o lote.
• Se todas as linhas forem válidas, uma tarefa será enfileirada, success será true e você receberá um job.id. Linhas individuais ainda podem falhar mais tarde, quando a plataforma as rejeitar no momento da publicação; isso aparece na tarefa, não aqui.

Faça a conciliação por clientReference quando possível e por index nos demais casos — as próprias linhas não são retornadas, então esses dois campos são o único vínculo com seus dados.

Observações.

• O corpo da requisição deve estar encapsulado em um objeto input, com as linhas em input.posts.
• Verifique success, não o status HTTP. Uma rejeição de todo o lote é um HTTP 200 com success: false e SY95050 em error.
• Máximo de 500 linhas por requisição. Um array maior é rejeitado imediatamente com SY95048 e nada é criado; divida-o e envie vários lotes.
• A marca de cada linha é socialProfileId. brandId é sempre usado apenas como um token de caminho de URL, e esta rota não tem nenhum token de caminho.
• As linhas podem se destinar a marcas diferentes. Os valores de platforms de cada linha são verificados em relação à própria marca dessa linha, então uma plataforma conectada a uma marca, mas não a outra, causa falha apenas nas linhas que precisam dela.
• Cada linha segue as mesmas regras de agendamento de uma publicação individual: scheduledAt ou scheduleDate + scheduleTime, nunca ambos, e scheduleDate / scheduleTime são interpretados no fuso horário da marca dessa linha. Você pode combinar as duas formas em linhas diferentes de um mesmo lote.
• Os limites de taxa se aplicam à requisição, não às linhas: um lote de 500 linhas consome uma requisição da sua cota. Consulte Limites de taxa.

Operação de escrita: não executada na conta real. A requisição e a resposta exibidas são construídas a partir do esquema da API; quando executada, esta operação publica em contas reais de redes sociais.