Публикации

Список публикаций

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

GEThttps://api.sofia-post.com/api/v1/posts

Список публикаций

Авторизации

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

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

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

Параметры запроса

establishmentIdstring

Только публикации этого заведения.

cursorstring

nextCursor предыдущей страницы.

statusstring

Live: хотя бы одна сеть в этом состоянии. status публикации обобщает её сети, поэтому фильтр failed может вернуть partial.

fromstring<date-time>

Live: хотя бы одна сеть опубликована (или до публикации запланирована) начиная с этого момента.

tostring<date-time>

Live: и до этого момента (не включая его).

createdBystring

Live: me для публикаций человека, от имени которого действует токен, app для созданных этим приложением. Не указано: все.

limitnumber

Размер страницы от 1 до 100 (по умолчанию 20).

Список публикаций

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

{
  "data": [
    {
      "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' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

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

GET /v1/posts перечисляет все публикации, доступные токену, начиная с самых свежих, с фильтрами establishmentId, status, from, to и createdBy (me или app). Публикация соответствует status, когда хотя бы одна из её сетей находится в этом состоянии. См. пагинацию.

Возможные состояния публикации описаны на странице Чтение публикации.

Авторизации

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

Параметры запроса

establishmentIdstring
Только публикации этого заведения.
cursorstring
nextCursor предыдущей страницы.
statusstring
Live: хотя бы одна сеть в этом состоянии. status публикации обобщает её сети, поэтому фильтр failed может вернуть partial.
Допустимые значения: draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
Live: хотя бы одна сеть опубликована (или до публикации запланирована) начиная с этого момента.
tostring<date-time>
Live: и до этого момента (не включая его).
createdBystring
Live: me для публикаций человека, от имени которого действует токен, app для созданных этим приложением. Не указано: все.
Допустимые значения: meapp
limitnumber
Размер страницы от 1 до 100 (по умолчанию 20).

Ответ

Страница публикаций, с nextCursor, если есть продолжение.

dataobject[]обязательно
Публикации страницы
Показать дочерние атрибуты
- 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>
  Когда публикация запланирована к выходу
nextCursorstring
Передайте как ?cursor= для следующей страницы; в конце отсутствует

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