Cara kerja
Hermes (komputer rumah / Linux) bicara langsung ke API publik https://dam-web.dam-web-ibnu.workers.dev pakai token link (dam_…). Token dikunci ke IP saat pertama dipakai (trust-on-first-use). Kalau IP rumah berubah, ada masa tenggang 10 menit untuk kunci ulang otomatis.
- Hermes boleh: baca semua data, tambah aset, usul edit.
- Hermes ditolak (403): hapus, checkout, mark-done, setuju/tolak usulan — itu wewenang owner di halaman Hermes.
- Unduh file:
POST /sign-downloadlalu GET URL presigned — Hermes boleh unduh. - Edit data hanya lewat
POST /proposals→ owner setujui di halaman Hermes.
Langkah 1 — Terbitkan token (di perangkat owner)
- Buka halaman Hermes → isi nama (mis.
hermes-rumah) → Terbitkan. - Salin token
dam_…yang tampil sekali itu — kirim ke Hermes lewat jalur aman (jangan ditempel di chat publik).
Langkah 2 — Klaim token (di komputer Hermes)
Jalankan sekali (ganti token). IP komputer ini langsung dikunci ke token:
curl -X POST https://dam-web.dam-web-ibnu.workers.dev/agent/claim -H "Content-Type: application/json" -d "{\"token\":\"dam_TEMPEL_DISINI\"}"
Balasan {"ok":true,"locked_ip":"…"} = berhasil. Simpan token sebagai env Hermes: DAM_TOKEN=dam_… dan DAM_API=https://dam-web.dam-web-ibnu.workers.dev.
Langkah 3 — Pakai API
curl $DAM_API/assets?limit=5 -H "Authorization: Bearer $DAM_TOKEN"
curl -X POST $DAM_API/proposals -H "Authorization: Bearer $DAM_TOKEN" -H "Content-Type: application/json" -d "{\"asset_id\":123,\"patch\":{\"tags\":\"baru\"},\"reason\":\"perbaikan\"}"
- Tambah aset:
POST /put-file(FormDatakey=slug/namafile +file) laluPOST /ingestdenganfiles:[{file_path,file_type}]. - Cek status usulan:
GET /proposals?status=all. - Unduh file:
POST /sign-download{"key":"slug/nama"}→ GET URL presigned yang dikembalikan.
Kalau koneksi ditolak
- IP tidak dikenal — grace 10 menit dibuka: IP rumah berubah. Dalam 10 menit, request lagi dari IP baru agar terkunci ulang otomatis. Owner melihat status
gracedi halaman Hermes. - Masa tenggang habis: minta owner terbitkan token baru (langkah 1–2 ulang).
- Token dicabut: owner mencabut dari halaman Hermes — minta token baru.
- Token belum diklaim: jalankan langkah 2 dulu sebelum pakai API.