Os posts pertencem a um usuário final e devem ter como destino uma das conexões sociais
desse usuário final. A plataforma de connectionId deve corresponder a socialMedia.
Criar um post de texto
Omita scheduledAt para colocar o post na fila imediatamente:
Para agendá-lo, passe um timestamp ISO 8601:
Use uma chave de idempotência estável e única para cada post lógico. Se a sua requisição
atingir o tempo limite, tente novamente com a mesma chave. As chaves devem ter de 1 a 255 caracteres e são
restritas ao espaço de trabalho do usuário final.
Listar e buscar posts
limit é restrito a 1 a 100. A resposta da listagem contém data, page,
limit e total.
Enviar mídia
Os envios de mídia usam um fluxo de três etapas:
- Solicite ao Social media studio uma URL de envio pré-assinada.
- Envie os bytes brutos do arquivo diretamente para essa URL com HTTP
PUT. Envie um
cabeçalho Content-Type igual ao mimetype que você declarou: a URL é
assinada com ele, então um PUT sem o cabeçalho, ou com outro valor, falha com
403 SignatureDoesNotMatch.
- Anexe as informações do arquivo retornadas ao criar o post.
Para vídeos, inclua duration em segundos ao solicitar a URL e ao anexar
o arquivo. As URLs de envio são temporárias; solicite uma nova se um envio tiver expirado.
Status do post
A resposta de criação confirma que o post foi aceito e colocado na fila; ela não
garante que a plataforma social o publicou. Use post.status, consulte
posts.get repetidamente ou assine os webhooks post.published e post.failed para obter o
resultado final.