v1Recursos/Posts/postRecuperar los destinos fallidos de una publicación

Recuperar los destinos fallidos de una publicación

Crea una nueva publicación en borrador para los destinos donde una publicación no se pudo publicar, para que puedas corregirla y enviarla de nuevo. Úsalo con una publicación cuyo estado sea partial (algunos destinos se publicaron y otros fallaron) o error (ninguno se publicó). El borrador copia el contenido y los medios del original y solo usa las conexiones que fallaron. No se publica ni se programa nada: edita el borrador si la red rechazó el contenido y luego prográmalo o publícalo como cualquier otra publicación. El borrador solo puede usar esos destinos fallidos, así que agregarle otra conexión se rechaza con 409. Los destinos publicados de la publicación original nunca cambian. Los destinos fallidos pasan al borrador y ya no se pueden reintentar desde el original, por lo que una publicación partial pasa a mostrarse como active. Si vuelves a llamar para la misma publicación, recibes el mismo borrador con 201 en lugar de uno nuevo. Si ese borrador se eliminó, la llamada devuelve 409 y no se crea otra recuperación. Un destino se queda en el original cuando su resultado es incierto (es posible que la red ya tenga la publicación), cuando ya hay un reintento en cola o cuando su plataforma no se ofrece actualmente. Si ningún destino cumple los requisitos, la llamada devuelve 422. Las publicaciones de series, las que forman parte de una publicación multicliente y las importadas no se pueden recuperar aquí. El usuario de la clave de API debe estar activo y tener acceso a Social y al cliente de la publicación. Si la recuperación no está disponible en tu espacio de trabajo, la llamada devuelve 404. No envíes cuerpo en la solicitud.

post/api/v1/posts/{id}/recover-failed
posts:write
Parámetros de consulta
idstringobligatorio
La publicación que no se pudo publicar, por id o id público.
Respuesta
dataobjectopcional
idstringopcional
El id del borrador de recuperación. Úsalo para editar, programar o publicar el borrador.
publicIdstringopcional
El id público del borrador de recuperación, o null si no tiene.
statusstringopcional
El estado del borrador de recuperación: draft en una recuperación nueva. Una llamada repetida devuelve el estado actual del borrador existente, por ejemplo scheduled cuando alguien ya lo programó.
connectionIdsarray of stringopcional
Las conexiones donde se publicará el borrador: los destinos fallidos de la publicación original.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409La publicación cambió mientras se creaba el borrador, ya existe una recuperación para esta publicación o se eliminó, o la publicación forma parte de una publicación multicliente. Actualiza la publicación e inténtalo de nuevo.
422La publicación no se puede recuperar: su estado no es partial ni error, pertenece a una serie, ningún destino fallido cumple los requisitos, o la conexión de un destino fallido está desconectada o no se ofrece.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
500No se pudo crear el borrador de recuperación. Actualiza la publicación e inténtalo de nuevo.
503No se pudo completar la operación.
post/api/v1/posts/{id}/recover-failed
Su clave de API
id *
{}

Guías que usan este recurso