v1Recursos/Posts/deleteRetirar y eliminar una publicación

Retirar y eliminar una publicación

Retira una publicación de todas las plataformas a las que se envió — una acción real e inmediata que no se puede deshacer. Solo cuando la retirada tiene éxito en todas las plataformas, la publicación también desaparece de esta API; si alguna plataforma falla, no se archiva nada y la publicación permanece visible para poder reintentar el fallo. Esta API nunca elimina permanentemente el registro de la publicación.

delete/api/v1/posts/{id}

posts:write

Parámetros de consulta

idstringobligatorio

La publicación a eliminar.

Respuesta

dataobjectopcional

idstringopcional

Identificador único de la publicación.

okbooleanopcional

Si todos los envíos a las plataformas se retiraron correctamente.

deletednumberopcional

Número de envíos a plataformas retirados correctamente.

failedarray of objectopcional

Envíos a plataformas que no se pudieron retirar, si los hay.

connectionIdstringopcional

ID de la conexión cuya retirada falló.

platformstringopcional

La plataforma a la que corresponde esta fila.

errorstringopcional

Mensaje de error que describe por qué falló la retirada.

Errores

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.

429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.

delete/api/v1/posts/{id}

Su clave de API

id *

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