Tulis Logotulis
Dokumentasi Resmi
|tulis.org

Arsitektur Dokumentasi

Peta jalan panduan, SDK integration, dan API reference lengkap yang disiapkan secara terstruktur.

TULIS CMS/DEVELOPER HUB
/api-reference-media-list-media

Daftar Media

Melihat daftar media (gambar dan file) dengan paginasi untuk sebuah workspace.

Endpoint

GET /v1/media

Autentikasi

Wajib. Berikan kunci API sebagai Bearer token dan identifikasi workspace melalui header X-Workspace-ID atau dengan mengakses API melalui subdomain workspace.

  • Authorization: Bearer ***
  • X-Workspace-ID: YOUR_WORKSPACE_ID

Atau, targetkan https://YOUR_WORKSPACE_SUBDOMAIN.YOUR_HOST sebagai pengganti mengirim X-Workspace-ID.

Parameter Kueri

ParameterTipeBawalanDeskripsi
pageinteger1Nomor halaman (berbasis 1).
per_pageinteger10Item per halaman.
mimestring(kosong)Filter berdasarkan tipe MIME, mis. image.

Respons

{
  "status": 200,
  "message": "Media berhasil diambil",
  "data": [
    {
      "id": "a7b8c9d0-7777-8888-9999-000011112222",
      "url": "https://cdn.tulis.app/media/cover-123.jpg",
      "filename": "cover-123.jpg",
      "mime_type": "image/jpeg",
      "size": 184320,
      "alt_text": "Seseorang membaca di laptop",
      "created_at": "2026-01-10T14:20:00Z"
    }
  ],
  "meta": {
    "Page": 1,
    "PerPage": 10,
    "Total": 15,
    "TotalPages": 2,
    "HasNext": true,
    "HasPrev": false
  }
}

Bentuk bidang di atas bersifat representatif dari item media pada umumnya. Lihat respons aktual workspace Anda untuk set bidang yang lengkap dan otoritatif.

Contoh cURL

curl "https://YOUR_HOST/v1/media?page=1&per_page=10" \
  -H "Authorization: Bearer ***" \
  -H "X-Workspace-ID: YOUR_WORKSPACE_ID"

Lini Masa Peluncuran Fitur

Fase 1: Setup Awal & KonfigurasiSELESAI

Docker Compose, pengaturan file environment, dan panduan setup lokal telah lengkap dibuat.

Fase 2: Referensi RESTful APISELESAI

Dokumentasi route endpoint publik, otentikasi JWT, dan kontrol hak akses telah selesai disusun.

Fase 3: Integrasi Frontend & Fitur LanjutSEDANG BERJALAN

Mempersiapkan boilerplate untuk Next.js client, manajemen revisi konten, dan optimasi query.