Медиа

Список медиа

Перечисляет медиатеку заведения, сначала новые, постранично, с URL, подписанными на текущее окно. Работает в тесте и в live.

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

Список медиа

Авторизации

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

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

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

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

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

Заведение, чья медиатека читается.

cursorstring

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

limitnumber

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

Список медиа

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

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

Список медиа

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/media?establishmentId=<establishmentId>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

Медиа заведения возвращаются начиная с самых свежих, по страницам: см. пагинацию.

url каждого медиа подписан и истекает: сохраняйте id и перечитывайте медиа через `GET /v1/media/{id}`, когда нужен свежий URL.

Авторизации

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

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

establishmentIdstringобязательно
Заведение, чья медиатека читается.
cursorstring
nextCursor предыдущей страницы.
limitnumber
Размер страницы от 1 до 100 (по умолчанию 20).

Ответ

Страница медиа, с nextCursor, если есть продолжение.

dataobject[]обязательно
Медиа страницы
Показать дочерние атрибуты
- idstringобязательно
  Идентификатор медиа, передаётся в media[].id публикации
- typestringобязательно
  Тип медиа
  Допустимые значения: imagevideo
- urlstringобязательно
  Подписанный адрес, действует на текущее окно
- fileNamestringобязательно
  Имя файла
- contentTypestringобязательно
  MIME-тип файла
- sizenumberобязательно
  Размер в байтах
- createdAtstring<date-time>обязательно
  Когда медиа было добавлено
- thumbnailUrlstring
  Подписанная миниатюра (постер видео, квадрат изображения)
nextCursorstring
Передайте как ?cursor= для следующей страницы; в конце отсутствует

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