Перейти к основному содержимому

Публикации

Получение списка публикаций​

Этот метод позволяет получить список всех публикаций, доступных в системе.

Запрос​

curl -X GET "https://api.postmypost.io/v4/publications?project_id=<id>&post_date=<YYYY-MM-DD>" \
-H "Authorization: Bearer <ваш_токен>"

Пример ответа​

[
  {
    "id": number,
    "post_at": string,
    "delete_at": string | null,
    "rubric_id": number | null,
    "account_ids": number[],
    "details": [
      {
        "account_id"?: number,
        "publication_type": number,
        "content"?: string,
        "comment"?: string,
        "link"?: string,
        "title"?: string,
        "tiktok_comment"?: boolean,
        "tiktok_duet"?: boolean,
        "tiktok_stitch"?: boolean,
        "tiktok_privacy_status"?: number,
        "youtube_privacy_status"?: number,
        "files"?: [
          {
            "id": number,
            "original": string
          }
        ]
      }
    ],
    "publication_status": number
  }
]

Значения publication_status

  • 0 — удален.
  • 1 — опубликован.
  • 2 — публикуется.
  • 3 — не публикуется из-за ошибки.
  • 4 — черновик.
  • 5 — ожидает публикации.
  • 6 — не удаляется из-за ошибки.
  • 10 — шаблон.
  • 11 — этап работы.
  • 12 — согласование.

Значения publication_type

  • 1 — post.
  • 2 — story.
  • 4 — reels/shorts/clips.

Значения tiktok_privacy_status

  • 1 — общедоступный для всех.
  • 2 — Взаимные друзья-подписчики.
  • 3 — только для себя.

Значения youtube_privacy_status

  • 1 — открытый доступ.
  • 2 — ограниченный доступ.
  • 3 — доступ по ссылке.

Получение одной публикации​

Этот метод позволяет получить данные конкретной публикации по её id.

Запрос​

curl -X GET "https://api.postmypost.io/v4/publications/<id>" \
-H "Authorization: Bearer <ваш_токен>"
  • <id> — идентификатор публикации, которую необходимо получить.

Пример ответа​

{
  "id": number,
  "post_at": string,
  "delete_at": string | null,
  "rubric_id": number | null,
  "account_ids": number[],
  "details": [
    {
      "account_id"?: number,
      "publication_type": number,
      "content"?: string,
      "comment"?: string,
      "link"?: string,
      "title"?: string,
      "tiktok_comment"?: boolean,
      "tiktok_duet"?: boolean,
      "tiktok_stitch"?: boolean,
      "tiktok_privacy_status"?: number,
      "youtube_privacy_status"?: number,
      "files": [
        {
          "id": number,
          "original": string
        }
      ]
    }
  ],
  "publication_status": number
}

Создание публикации​

Запрос​

curl -X POST "https://api.postmypost.io/v4/publications" \
-H "Authorization: Bearer <ваш_токен>" \
-H "Content-Type: application/json" \
-d '{
  "project_id": number,
  "post_at": string,
  "delete_at"?: number | null,
  "rubric_id"?: number | null,
  "account_ids": number[],
  "publication_status": number,
  "details": [
    {
      "account_id"?: number | null,
      "publication_type": number,
      "content"?: string | null,
      "comment"?: string | null,
      "link"?: string,
      "title"?: string | null,
      "tiktok_comment"?: boolean | null,
      "tiktok_duet"?: boolean | null,
      "tiktok_stitch"?: boolean | null,
      "tiktok_privacy_status"?: number | null,
      "youtube_privacy_status"?: number | null,
      "file_ids"?: number[] | null,
    }
  ]
}'

Описание параметров​

  • project_id — id проекта, к которому относится публикация.
  • post_at — дата и время запланированной публикации в формате yyyy-mm-dd hh:mm:ss.
  • delete_at — время, когда публикация будет удалена.
  • rubric_id — id рубрики.
  • account_ids — массив идентификаторов аккаунтов, на которых пост будет опубликован.
  • publication_status — статус публикации. например, 4 соответствует "черновику".
  • details — список параметров публикации
  • account_id — id аккаунта для этого элемента публикации (можете не указывать, если актуально для всех).
  • content — основное содержание публикации.
  • comment — комментарий к публикации.
  • link — ссылка.
  • file_ids — массив id файлов, прикрепленных к публикации.
  • title — заголовок публикации.
  • tiktok_comment — флаг, разрешающий комментарии в TikTok.
  • tiktok_duet — флаг, разрешающий создание дуэтов в TikTok.
  • tiktok_stitch — флаг, разрешающий использование Stitch в TikTok.
  • tiktok_privacy_status — настройки приватности для публикации в TikTok.
  • youtube_privacy_status — настройки приватности для публикации в YouTube.

Пример ответа​

{
  "id": number,
  "post_at": string,
  "delete_at": string | null,
  "rubric_id": number | null,
  "account_ids": number[],
  "details": [
    {
      "account_id"?: number,
      "publication_type": number,
      "content"?: string,
      "comment"?: string,
      "link"?: string,
      "title"?: string,
      "tiktok_comment"?: boolean,
      "tiktok_duet"?: boolean,
      "tiktok_stitch"?: boolean,
      "tiktok_privacy_status"?: number,
      "youtube_privacy_status"?: number,
      "files": {
        "id": number,
        "original": string
      }[]
    }
  ],
  "publication_status": number
}

Обновление публикации​

Запрос​

curl -X PUT "https://api.postmypost.io/v4/publications/<id>" \
-H "Authorization: Bearer <ваш_токен>" \
-H "Content-Type: application/json" \
-d '{
  "post_at": string,
  "delete_at"?: string | null,
  "rubric_id"?: number | null,
  "account_ids": number[],
  "publication_status": number,
  "details": [
    {
      "account_id"?: number | null,
      "publication_type": number,
      "content"?: string | null,
      "comment"?: string | null,
      "link"?: string,
      "title"?: string | null,
      "tiktok_comment"?: boolean | null,
      "tiktok_duet"?: boolean | null,
      "tiktok_stitch"?: boolean | null,
      "tiktok_privacy_status"?: number | null,
      "youtube_privacy_status"?: number | null,
      "file_ids"?: number[] | null,
    }
  ]
}'

Пример ответа​

{
  "id": number,
  "post_at": string,
  "delete_at": string | null,
  "rubric_id": number | null,
  "account_ids": number[],
  "details": [
    {
      "account_id"?: number,
      "publication_type": number,
      "content"?: string,
      "comment"?: string,
      "link"?: string,
      "title"?: string,
      "tiktok_comment"?: boolean,
      "tiktok_duet"?: boolean,
      "tiktok_stitch"?: boolean,
      "tiktok_privacy_status"?: number,
      "youtube_privacy_status"?: number,
      "files": {
        "id": number,
        "original": string
      }[]
    }
  ],
  "publication_status": number
}

Удаление публикации​

Запрос​

curl -X DELETE "https://api.postmypost.io/v4/publications/<id>?delete_option=1&account_ids=<account_id>,<account_id>" \
-H "Authorization: Bearer <ваш_токен>"
  • <id> — идентификатор публикации, которую необходимо удалить.
  • account_ids — массив идентификаторов аккаунтов, на которых пост будет удалён.

Значения delete_option

  • 1 — удалить публикацию везде (в Postmypost и в социальной сети).
  • 2 — удалить публикацию только в социальной сети.
  • 3 — удалить публикацию только в системе Postmypost.