API Reference

Reference ini adalah spesifikasi HTTP API untuk pengembang yang menangani WEEGLOO langsung dari kode. Blok endpoint di setiap halaman resource dirender sebagai konsol tempat Anda dapat mengisi path, header, dan body sendiri lalu benar-benar memanggilnya. Anda bisa langsung memeriksa di sana seperti apa bentuk permintaan dan dalam bentuk apa respons dikembalikan.

AI agent tidak memanggil HTTP API ini secara langsung, melainkan menggunakan WEEGLOO MCP tool. Spesifikasi di bawah ditujukan untuk saat Anda memanggil API secara langsung dari kode aplikasi seperti frontend, backend, atau skrip.

API dan Base URL

WEEGLOO menyediakan beberapa API yang terbagi menurut kegunaannya. Pilih dan gunakan Base URL yang sesuai dengan API yang akan dipanggil. Jangan menebak atau mengubah host.

Path mengacu pada /v1/.... Sebagai contoh, daftar Content di dalam suatu Space adalah https://cma.weegloo.com/v1/spaces/{spaceId}/contents.

Identitas dan token

WEEGLOO memiliki dua sistem identitas yang sepenuhnya terpisah satu sama lain. API yang dapat dipanggil ditentukan oleh identitas mana yang menerbitkan token tersebut.

Weegloo User adalah akun platform WEEGLOO. Saat Anda pertama kali login (misalnya melalui login sosial), akun langsung dibuat saat itu juga (login pertama sekaligus pendaftaran). Namun, untuk menangani konten suatu Space tertentu, Anda harus menjadi anggota Space tersebut, dan keanggotaan ditentukan oleh undangan dari orang yang sudah bergabung serta pemberian SpaceRole. Artinya, akun itu sendiri bebas dibuat, tetapi Space mana yang dapat Anda masuki dan apa yang dapat Anda lakukan dikendalikan oleh keanggotaan dan peran. Token Bearer dari identitas ini (PersonalAccessToken untuk server dan CI, atau token yang diterima melalui login studio konten) mengautentikasi CMA, Upload, CDA. Untuk pengiriman publik yang diekspos ke browser, alih-alih token tersebut gunakan DeliveryAccessToken (CDA) yang dipersempit izinnya seminimal mungkin.

ServiceUser adalah end-user yang mendaftar ke produk (mendaftar melalui ServiceLogin). Kepada siapa pendaftaran dibuka dan apakah pendaftaran baru memerlukan persetujuan administrator ditentukan oleh pengaturan ServiceLogin. Token Bearer dari identitas ini (diterbitkan dari auth.weegloo.com) mengautentikasi ACMA, ACDA, dan Upload. Token ini tidak dapat digunakan untuk CMA dan CDA.

Token tidak melintasi batas identitas. Token ServiceUser tidak boleh dikirim ke CMA dan CDA, dan token Weegloo User bukan pemanggil yang valid untuk ACMA dan ACDA. Satu-satunya permukaan yang dibagikan oleh kedua identitas adalah Upload, dan tempat Media dibuat setelah unggahan terbagi menurut identitas: CMA (Weegloo User) atau ACMA (ServiceUser).

Konvensi umum

Keempat hal berikut tidak terbatas pada resource tertentu dan berlaku umum untuk semua panggilan. Setiap halaman resource mengasumsikan konvensi ini berlaku dan hanya membahas isi yang khas untuknya.

• Properti sistem (sys): struktur metadata sys semua resource (id, version, Refer, status publikasi).
• Parameter kueri umum: pengambilan daftar (limit, order, filter) dan paginasi berbasis kursor.
• Konvensi: tipe media respons, modifikasi parsial (JSON Patch), kontrol konkurensi (X-Weegloo-Version).
• Error: format respons error dan kode umum.

Reference resource

Spesifikasi resource per API dibahas di hub berikut.

• CMA: model dan manajemen konten: Content Type, Content, Media, Tag, Locale, serta resource manajemen seperti token, organisasi, Space, peran, Webhook, WebHosting, ServiceLogin.
• CDA: pengiriman: pengiriman hanya-baca untuk konten yang dipublikasikan.
• Upload: mengunggah file untuk menerima Upload yang digunakan dalam pembuatan Media dan WebHosting.
• Auth: login OAuth dan pertukaran token ServiceUser.
• ACMA: manajemen konten anggota aplikasi (ServiceUser).
• ACDA: pengiriman konten yang dipublikasikan kepada anggota aplikasi (ServiceUser).