Synupv1
Criar chave
v1Recursos/Post Ideas/postPublicar uma ideia de publicação

Publicar uma ideia de publicação

Publica uma ideia de publicação como uma publicação real, enviando-a para suas plataformas de destino. A menos que scheduledFor ou draft esteja definido, isso envia conteúdo real ao vivo imediatamente. id aceita o próprio id da ideia ou o externalId com o qual foi criada.

post/api/v1/post-ideas/{id}/publish
posts:write
Parâmetros de consulta
idstringobrigatório
A ideia de publicação a ser publicada — seu id ou externalId.
Corpo da solicitação
scheduledForstringopcional
Publica neste timestamp ISO 8601 futuro em vez de imediatamente.
draftbooleanopcional
Salva como uma publicação em rascunho em vez de publicar imediatamente.
Resposta
dataobjectopcional
Uma plataforma solicitada sem conexão ativa, ou um campo que a ideia precisa antes de poder ir ao ar, nunca faz esta chamada falhar — a ideia é salva como uma publicação em rascunho. Chamar isso novamente para uma ideia que já tem uma publicação retorna alreadyPublished: true em vez de criar uma segunda.
postIdstringopcional
ID da publicação com a qual esta ideia foi publicada, ou null se a publicação não foi concluída.
statusstringopcional
Status da ideia: draft, published ou archived.
ideaIdstringopcional
ID da ideia de publicação que foi publicada.
alreadyPublishedbooleanopcional
Se esta ideia já tinha uma publicação de uma chamada anterior — quando true, nada novo foi publicado.
missingFieldsarray of stringopcional
Campos ainda necessários antes que a publicação resultante possa ir ao ar, se houver.
missingPlatformsarray of stringopcional
Plataformas solicitadas sem conexão ativa, se houver.
scopestring (location | client)opcional
Se a lacuna de conexão/campo se aplica no nível do local ou do cliente.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/post-ideas/{id}/publish
Sua chave de API
id *
Corpo da solicitação
{
  "data": {
    "postId": "cm_post_xyz789",
    "status": "scheduled",
    "ideaId": "cm_idea_abc123"
  }
}