Despublicar

Cancela una publicación pendiente sin eliminar el historial.

POST/publications/{id}/cancelpublications:write

COMPORTAMIENTO

El cambio se valida y persiste en la cuenta clave antes de responder. Consulta el recurso devuelto como fuente de verdad.

EFECTO

Puede cambiar el recurso y emitir el evento de dominio correspondiente.

REPETICIÓN

En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.

Solicitar

idstring · pathIdentificador de recursos.minLength 2 · maxLength 100obligatorio

reasonstring · bodyMotivo operativo de cancelación.maxLength 500opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Alcancepublications:write

Ejemplo ejecutable

curl

curl -X POST 'https://achadu.com/api/v1/publications/resource_id/cancel' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "reason": "string"
}'

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

200 application/json

{
  "data": {
    "id": "pub_01J...",
    "state": "queued",
    "group_id": "grp_01J...",
    "offer_id": "off_01J...",
    "error": null
  },
  "request_id": "req_01J..."
}

200Operación completada.

400Parámetro, cuerpo o transición no válidos.

401Clave faltante, inválida, caducada o revocada.

402El plan de cuenta no libera esta interfaz.

403A chave precisa do escopo publications:write.

404La característica no existe en esta cuenta.

409El estado actual impide esta operación.

413El cuerpo JSON supera los 128 KB.

429Se ha superado la ventana de 120 solicitudes por minuto.

Despublicar

Solicitar

Ejemplo ejecutable

Respuesta y errores

Operaciones relacionadas