Crear publicaciones

La respuesta es 202 Accepted, nunca 200. Nada se publica dentro de la petición: la publicación se encola y un worker la envía, así que la respuesta dice qué se ha aceptado, no qué se ha publicado.

{
  "object": "post_batch",
  "campaignId": "b3f1...",
  "posts": [
    {
      "object": "post_result",
      "id": "pQ7x...",
      "accountId": "acc_linkedin",
      "platform": "linkedin",
      "status": "accepted",
      "reason": null,
      "message": null,
      "readiness": {
        "characterCount": 22,
        "characterLimit": 3000,
        "overLimit": false,
        "mediaRequired": false,
        "settingsRequired": false,
        "publishBlocker": null
      },
      "editUrl": "https://antwork.io/workspace/ws_1/compose?postId=pQ7x...",
      "settingsUrl": "https://antwork.io/workspace/ws_1/compose?postId=pQ7x...&focus=settings"
    },
    {
      "object": "post_result",
      "id": null,
      "accountId": "acc_x",
      "platform": "x",
      "status": "rejected",
      "reason": "text_too_long",
      "message": "@antwork: Text exceeds x character limit",
      "readiness": null,
      "editUrl": null,
      "settingsUrl": null
    }
  ]
}

posts asigna una entrada a una publicación, así que cada una lleva su propio texto, hashtags, etiquetas, medios y ajustes. Los hashtags se añaden al texto donde la plataforma los publica (YouTube los guarda como etiquetas del vídeo). userTags etiqueta una página de empresa de LinkedIn ({"company": "https://www.linkedin.com/company/acme"}, con @Acme en el texto) o a personas en medios de Instagram ({"type": "photo_tag", "username": "acme", "x": 0.5, "y": 0.5}). Los medios tienen que ser archivos de la biblioteca de este espacio de trabajo; si no, la petición se rechaza con media_not_in_library. Más de una entrada forma una campaña.

{
  "draft": true,
  "posts": [
    { "accountId": "acc_linkedin", "text": "Shipped the API today. @Acme", "hashtags": ["buildinpublic"],
      "userTags": [{ "company": "https://www.linkedin.com/company/acme" }] },
    { "accountId": "acc_youtube", "text": "How the API works", "media": ["https://firebasestorage.googleapis.com/..."],
      "options": { "privacyStatus": "unlisted", "title": "The Antwork API in 60 seconds" } },
    { "accountId": "acc_pinterest", "text": "Ship notes", "media": ["https://firebasestorage.googleapis.com/..."],
      "options": { "boardId": "1234567890" } }
  ]
}

La entrada de cada publicación creada lleva readiness y dos enlaces al editor de Antwork. readiness.publishBlocker es el motivo por el que se rechazaría publicarla ahora mismo (en un borrador: media_required, tiktok_privacy_required, pinterest_board_required, etc.), o null. mediaRequired, settingsRequired, overLimit, characterCount y characterLimit explican por qué. editUrl abre la publicación en el editor y settingsUrl abre sus ajustes. Una entrada rechazada tiene los tres a null.

{
  "object": "post_result",
  "id": "pQ7x...",
  "accountId": "acc_tiktok",
  "platform": "tiktok",
  "status": "accepted",
  "reason": null,
  "message": null,
  "readiness": {
    "characterCount": 42,
    "characterLimit": 2200,
    "overLimit": false,
    "mediaRequired": false,
    "settingsRequired": true,
    "publishBlocker": "tiktok_privacy_required"
  },
  "editUrl": "https://antwork.io/workspace/ws_1/compose?postId=pQ7x...",
  "settingsUrl": "https://antwork.io/workspace/ws_1/compose?postId=pQ7x...&focus=settings"
}

• ›accepted — creada y programada (o guardada, si es un borrador). Consulta el id para ver qué pasa.
• ›rejected — rechazada antes de escribir nada. No existe; corrige reason y vuelve a enviar.
• ›failed — se creó pero no se pudo programar. Existe y no va a salir.

Omite scheduledFor para publicar de inmediato. Indica una hora ISO 8601 para programar: hasta 30 días vista en Free, sin límite en los planes de pago. En Free, una hora posterior se rechaza con scheduled_for_too_far, y el error indica la última hora que admite. Una hora en el pasado se rechaza con scheduled_for_in_past.

Todo lo específico de una plataforma va en options, indexado por plataforma y aplicado a todas las cuentas de esa plataforma en la petición. Son los ajustes que ofrece el editor de Antwork, con los mismos valores y límites. Los ajustes de TikTok los elige el usuario en cada publicación, así que un options.tiktok de nivel superior se rechaza con tiktok_settings_need_the_creator: envíalos por publicación, en posts[].options.

Envía una cabecera Idempotency-Key en cada creación, para que un reintento no publique dos veces. Cómo se comporta la clave está en la página de Idempotencia. Idempotencia →