MediaDaftar media
Kembali ke Sofia

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
GET/v1/media
curl -X GET 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Otorisasi

  • Authorizationstringwajib

    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

200application/json

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

400

invalid_cursor, atau invalid_request.

404

establishment_not_found: di luar jangkauan token.

4XXapplication/json

Kesalahan lain apa pun, dalam amplop kesalahan.