ПубликацииСписок публикаций
Назад к Sofia

Публикации

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

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

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

Авторизации

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

    Ваш личный ключ или токен доступа 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).

Ответ

200application/json

Страница публикаций, с 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= для следующей страницы; в конце отсутствует

400

invalid_cursor или invalid_request при неверном параметре.

401

Токен отсутствует, неизвестен, просрочен или отозван.

403

У токена нет разрешения posts:read.

404

establishment_not_found: заведение недоступно токену.

4XXapplication/json

Любая другая ошибка в конверте ошибки.