v1Recursos/Posts/deleteRemover e excluir uma publicação

Remover e excluir uma publicação

Remove uma publicação de todas as plataformas em que foi enviada — uma ação real e imediata que não pode ser desfeita. Somente quando a remoção é bem-sucedida em todas as plataformas é que a publicação também desaparece desta API; se alguma plataforma falhar, nada é arquivado e a publicação permanece visível para que a falha possa ser repetida. Esta API nunca exclui permanentemente o registro da publicação.

delete/api/v1/posts/{id}

posts:write

Parâmetros de consulta

idstringobrigatório

A publicação a ser excluída.

Resposta

dataobjectopcional

idstringopcional

Identificador único da publicação.

okbooleanopcional

Se todos os envios de plataforma foram removidos com sucesso.

deletednumberopcional

Número de envios de plataforma removidos com sucesso.

failedarray of objectopcional

Envios de plataforma que falharam ao serem removidos, se houver.

connectionIdstringopcional

ID da conexão cuja remoção falhou.

platformstringopcional

A plataforma a que esta linha se refere.

errorstringopcional

Mensagem de erro descrevendo por que a remoção falhou.

Erros

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.

429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.

delete/api/v1/posts/{id}

Sua chave de API

id *

{
  "data": {
    "id": "cm_post_abc123",
    "ok": true,
    "deleted": 2,
    "failed": []
  }
}