Публикации

Изменить публикацию

Пока ни одна сеть не начала отправку, заменяет targets, задаёт scheduledAt или переводит публикацию между draft и scheduled. Пропущенное сохраняется.

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}

Изменить публикацию

Авторизации

Authorizationstringобязательно

Ваш личный ключ или токен доступа OAuth, отправляется как Bearer <token>.

Хранится только в этой вкладке и отправляется только на api.sofia-post.com. Получить ключ API

Параметры пути

idstringобязательно

Идентификатор публикации.

Тело

Этот запрос действует на ваш реальный аккаунт.

Изменить публикацию

curl -X PATCH 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"scheduledAt":"2026-11-02T10:00:00.000Z"}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

Изменить публикацию

curl --request PATCH \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2026-11-02T10:00:00.000Z"
}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

PATCH /v1/posts/{id} переписывает цели, переносит scheduledAt или меняет status: draft убирает расписание и сохраняет содержимое, scheduled переносит его. После того как сеть отправила публикацию, ответ — 409 post_not_editable.

curl -X PATCH https://api.sofia-post.com/api/v1/posts/$POST_ID \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"scheduled","scheduledAt":"2026-11-20T09:00:00Z"}'

Авторизации

Authorizationstringheaderобязательно
Ваш личный ключ или токен доступа OAuth, отправляется как Bearer <token>.

Параметры пути

idstringобязательно
Идентификатор публикации.

Тело

application/json

targetsobject[]
Все цели, переписанные (текст, медиа, формат, аккаунт); не указано: сохраняются
Показать дочерние атрибуты
- platformstringобязательно
  Целевая сеть
  Допустимые значения: instagramfacebookxlinkedintiktok
- textstringобязательно
  Подпись, публикуемая в этой сети
- mediaobject[]
  Прикреплённые медиа
  Показать дочерние атрибуты
  - idstring
    Идентификатор медиа из медиатеки заведения (иначе url и type)
  - urlstring
    Публичный адрес медиа (https в live); без идентификатора
  - typestring
    Тип медиа, заданного адресом
    Допустимые значения: imagevideo
- formatstring
  Формат (post, reel, story, carousel...); по умолчанию тот, что выдала бы сеть
- accountIdstring
  Live: подключённый аккаунт, который публикует, если у заведения их несколько в этой сети (GET /v1/establishments/:id/accounts)
scheduledAtstring<date-time>
Новая дата в будущем: публикация планируется на эту дату
statusstring
draft: назад в черновик (содержимое сохраняется, время теряется); scheduled: запланировать на scheduledAt или на прежнее время
Допустимые значения: draftscheduled

Ответ

Публикация после изменения.

idstringобязательно
Идентификатор публикации
statusstringобязательно
По всем сетям; partial: опубликовано в одной, ошибка в другой
Допустимые значения: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstringобязательно
Заведение публикации
createdAtstring<date-time>обязательно
Когда публикация была создана
targetsobject[]обязательно
Одна запись на сеть и аккаунт: два аккаунта в одной сети дают две записи
Показать дочерние атрибуты
- platformstringобязательно
  Сеть цели
- accountIdstringобязательно
  Аккаунт, который публикует (GET /v1/establishments/:id/accounts)
- statestringобязательно
  Состояние цели в её сети
  Допустимые значения: draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  Когда цель была опубликована
- permalinkstring
  Ссылка на опубликованную публикацию в сети
- errorstring
  Почему сеть отклонила
scheduledAtstring<date-time>
Когда публикация запланирована к выходу

Эта страница была полезной?