v1Recursos/Posts/postRecuperar os destinos com falha de uma publicação

Recuperar os destinos com falha de uma publicação

Cria uma nova publicação em rascunho para os destinos em que uma publicação não pôde ser publicada, para que você possa corrigi-la e enviá-la de novo. Use em uma publicação com status partial (alguns destinos foram publicados e outros falharam) ou error (nenhum foi publicado). O rascunho copia o conteúdo e a mídia do original e usa apenas as conexões que falharam. Nada é publicado nem agendado: edite o rascunho se a rede recusou o conteúdo e depois agende ou publique como qualquer outra publicação. O rascunho só pode usar esses destinos com falha, então adicionar outra conexão a ele é recusado com 409. Os destinos publicados da publicação original nunca são alterados. Os destinos com falha passam para o rascunho e não podem mais ser tentados de novo a partir do original, por isso uma publicação partial passa a aparecer como active. Chamar de novo para a mesma publicação retorna o mesmo rascunho com 201, em vez de criar outro. Se esse rascunho foi excluído, a chamada retorna 409 e nenhuma nova recuperação é criada. Um destino fica no original quando o resultado é incerto (a rede talvez já tenha a publicação), quando já há uma nova tentativa na fila ou quando a plataforma não é oferecida no momento. Se nenhum destino se qualificar, a chamada retorna 422. Publicações de séries, publicações que fazem parte de uma publicação multicliente e publicações importadas não podem ser recuperadas aqui. O usuário da chave de API precisa estar ativo e ter acesso a Social e ao cliente da publicação. Se a recuperação não estiver disponível no seu espaço de trabalho, a chamada retorna 404. Não envie corpo na requisição.

post/api/v1/posts/{id}/recover-failed
posts:write
Parâmetros de consulta
idstringobrigatório
A publicação que não pôde ser publicada, por id ou id público.
Resposta
dataobjectopcional
idstringopcional
O id do rascunho de recuperação. Use-o para editar, agendar ou publicar o rascunho.
publicIdstringopcional
O id público do rascunho de recuperação, ou null se não houver.
statusstringopcional
O status do rascunho de recuperação: draft em uma recuperação nova. Uma chamada repetida retorna o status atual do rascunho existente, por exemplo scheduled depois que alguém o agendou.
connectionIdsarray of stringopcional
As conexões em que o rascunho será publicado: os destinos com falha da publicação original.
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.
409A publicação mudou enquanto o rascunho era criado, já existe uma recuperação para esta publicação ou ela foi excluída, ou a publicação faz parte de uma publicação multicliente. Atualize a publicação e tente de novo.
422A publicação não pode ser recuperada: o status não é partial nem error, ela pertence a uma série, nenhum destino com falha se qualifica, ou a conexão de um destino com falha está desconectada ou não é oferecida.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
500Não foi possível criar o rascunho de recuperação. Atualize a publicação e tente de novo.
503Não foi possível concluir a operação.
post/api/v1/posts/{id}/recover-failed
Sua chave de API
id *
{}

Guias que usam este recurso