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

Публикации

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

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

Запрос​

curl -X GET "https://api.postmypost.io/v4/publications" \
-H "Authorization: Bearer <ваш_токен>"

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

[
  {
    "id": number,
    "post_at": string,
    "delete_at": string | null,
    "rubric_id": number | null,
    "account_ids": number[],
    "details": [
      {
        "account_id": number | null,
        "publication_type": number,
        "content": string | null,
        "comment": string | null,
        "files": [
          {
            "id": number,
            "original": string
          }
        ] | null
      }
    ],
    "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.

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

Этот метод позволяет получить данные конкретной публикации по её 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 | null,
      "publication_type": number,
      "content": string | null,
      "comment": string | null,
      "files": [
        {
          "id": number,
          "original": string
        }
      ] | null
    }
  ],
  "publication_status": number
}

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

Запрос​

curl -X POST "http://api.postmypost.loc/v4/publications" \
-H "Authorization: Bearer <ваш_токен>" \
-H "Content-Type: application/json" \
-d '{
  "project_id": number,
  "post_at": string,
  "delete_at": number | null,
  "account_ids": number[],
  "publication_status": number,
  "details": [
    {
      "account_id": number | null,
      "publication_type": number | null,
      "content": string | null,
      "comment": string | null,
      "file_ids": number[] | null,
    }
  ]
}'

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

  • project_id — id проекта, к которому относится публикация.
  • post_at — дата и время запланированной публикации в формате yyyy-mm-dd hh:mm:ss.
  • delete_at — время, когда публикация будет удалена (может быть установлено в null).
  • account_ids — массив идентификаторов аккаунтов, на которых пост будет опубликован.
  • publication_status — статус публикации. например, 4 соответствует "черновику".
  • details — список параметров публикации
  • account_id — id аккаунта для этого элемента публикации (может быть null, если актуально для всех).
  • content — основное содержание публикации.
  • comment — комментарий к публикации.
  • file_ids — массив id файлов, прикрепленных к публикации.

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

{
  "id": number,
  "post_at": string,
  "delete_at": string | null,
  "rubric_id": number | null,
  "account_ids": number[],
  "details": [
    {
      "account_id": number | null,
      "publication_type": number,
      "content": string | null,
      "comment": string | null,
      "files": [
        {
          "id": number,
          "original": string
        }
      ] | null
    }
  ],
  "publication_status": number
}

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

Запрос​

curl -X PUT "http://api.postmypost.loc/v4/publications/<id>" \
-H "Authorization: Bearer <ваш_токен>" \
-H "Content-Type: application/json" \
-d '{
  "post_at": string,
  "delete_at": number | null,
  "account_ids": number[],
  "publication_status": number,
  "details": [
    {
      "account_id": number | null,
      "publication_type": number | null,
      "content": string | null,
      "comment": string | 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 | null,
      "publication_type": number,
      "content": string | null,
      "comment": string | null,
      "files": [
        {
          "id": number,
          "original": string
        }
      ] | null
    }
  ],
  "publication_status": number
}

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

Запрос​

DELETE  http://api.postmypost.loc/v4/publications/<id>?delete_option=1&account_ids=<account_id>,<account_id>
Authorization: Bearer <ваш_токен>

Значения delete_option

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