Media

Daftar media

Mendaftar pustaka media sebuah usaha, terbaru lebih dulu, per halaman, dengan URL bertanda tangan untuk jendela saat ini. Berfungsi di mode uji dan live.

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

Daftar media

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

Daftar media

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

Media sebuah usaha dikembalikan dengan yang terbaru lebih dulu, halaman demi halaman: lihat paginasi.

url setiap media bertanda tangan dan kedaluwarsa: simpan id-nya, dan baca ulang media dengan `GET /v1/media/{id}` saat Anda butuh URL baru.

Otorisasi

Authorizationstringheaderwajib
Kunci pribadi atau access token OAuth Anda, dikirim sebagai Bearer <token>.

Parameter query

establishmentIdstringwajib
Usaha yang pustaka medianya dibaca.
cursorstring
nextCursor dari halaman sebelumnya.
limitnumber
Ukuran halaman, dari 1 sampai 100 (default 20).

Respons

Satu halaman media, dengan nextCursor bila masih ada lanjutan.

dataobject[]wajib
Media di halaman ini
Tampilkan atribut turunan
- idstringwajib
  Pengenal media, untuk diteruskan di media[].id sebuah postingan
- typestringwajib
  Jenis media
  Nilai yang diizinkan: imagevideo
- urlstringwajib
  Alamat bertanda tangan, berlaku untuk jendela saat ini
- fileNamestringwajib
  Nama file
- contentTypestringwajib
  Tipe MIME file
- sizenumberwajib
  Ukuran dalam byte
- createdAtstring<date-time>wajib
  Kapan media ditambahkan
- thumbnailUrlstring
  Thumbnail bertanda tangan (poster video, persegi untuk gambar)
nextCursorstring
Teruskan sebagai ?cursor= untuk halaman berikutnya; tidak ada di akhir

Apakah halaman ini membantu?