Публикации

Получить публикацию

Возвращает публикацию с состоянием каждой сети, ссылкой после публикации и ошибкой. В live любая публикация Workspace, в тесте имитированная.

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

Получить публикацию

curl -X GET 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "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 GET \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "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"
    }
  ]
}

Прочитайте публикацию, чтобы следить за состоянием каждой её сети: каждая цель переходит в published со своей постоянной ссылкой или в failed с причиной. Чтобы получать уведомления, не опрашивая API, зарегистрируйте вебхук.

{
  "id": "efc578cc-ef79-40e9-876d-be1a33d3b8db",
  "status": "published",
  "targets": [
    {
      "platform": "instagram",
      "state": "published",
      "publishedAt": "2026-11-02T20:17:25.453Z",
      "permalink": "https://www.instagram.com/p/DfQJVPGFfb_/"
    }
  ]
}

Состояния

Состояние	Значение
`draft`	Сохранена, не уходит
`scheduled`	Уйдёт в `scheduledAt`
`publishing`	Отправляется в сеть
`published`	В сети, с её `permalink`
`failed`	Сеть её отклонила; `error` говорит почему
`sent_to_inbox`	Отправлена в приложение сети, где владелец её завершает (TikTok)

status публикации обобщает её цели. Он равен partial, когда одна сеть опубликовала, а другая нет.

Авторизации

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

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

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

Ответ

Публикация и состояние каждой цели.

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>
Когда публикация запланирована к выходу

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