{"openapi":"3.1.0","info":{"title":"ARstudio API","version":"1.0.0","description":"Buat, update, dan pantau pengalaman AR dari aplikasimu. Auth: header `Authorization: Bearer arb_live_…` (buat di Dashboard → API Key). Tersedia di paket Pro & Bisnis."},"servers":[{"url":"/api/v1"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"arb_live_…"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"Project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"live":{"type":"boolean"},"url":{"type":"string","description":"Link AR untuk dibuka di HP / dijadikan QR"},"embed":{"type":"string","description":"Kode iframe untuk ditanam di website"},"bytes":{"type":"integer"},"opens":{"type":"integer"},"scans":{"type":"integer"},"created":{"type":"integer"},"updated":{"type":"integer"}}},"Scene":{"type":"object","description":"Format scene ARstudio. Lebar marker = 1 unit; marker rebah di bidang XZ, +Y keluar dari marker.","required":["targets","entities"],"properties":{"name":{"type":"string"},"targets":{"type":"array","items":{"type":"object","required":["id","image","aspect"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"image":{"type":"string","description":"ID aset gambar"},"aspect":{"type":"number","description":"tinggi / lebar gambar"}}}},"mind":{"type":"object","description":"File .mind hasil compile semua target (urutan = urutan targets)","properties":{"asset":{"type":"string"},"key":{"type":"string"}}},"entities":{"type":"array","items":{"type":"object","required":["id","type","targetId"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"enum":["model","image","video","audio","text","youtube","web","box","sphere","cylinder","cone","torus","plane"]},"targetId":{"type":"string"},"position":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"rotation":{"type":"array","items":{"type":"number"},"description":"derajat"},"scale":{"type":"array","items":{"type":"number"}},"visible":{"type":"boolean"},"props":{"type":"object","description":"asset, color, text, url, autoplay, loop, chroma, …"},"anim":{"type":"object","properties":{"type":{"enum":["none","spin","bob","pulse","clip"]},"speed":{"type":"number"}}},"onTap":{"type":"array","items":{"$ref":"#/components/schemas/Action"}},"onFound":{"type":"array","items":{"$ref":"#/components/schemas/Action"}}}}}}},"Action":{"oneOf":[{"type":"object","properties":{"type":{"enum":["openUrl","openWeb"]},"url":{"type":"string"}},"required":["type","url"]},{"type":"object","properties":{"type":{"enum":["toggle","show","hide","play","pause"]},"target":{"type":"string"}},"required":["type","target"]}]},"Stats":{"type":"object","properties":{"open":{"type":"integer"},"found":{"type":"object","additionalProperties":{"type":"integer"}},"tap":{"type":"object","additionalProperties":{"type":"integer"}},"days":{"type":"object","additionalProperties":{"type":"integer"}}}}}},"paths":{"/me":{"get":{"summary":"Info akun, paket & pemakaian","responses":{"200":{"description":"OK"},"401":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects":{"get":{"summary":"Daftar project","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}}}}}}},"post":{"summary":"Buat project baru (kosong, belum live)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}}}}}},"responses":{"201":{"description":"Dibuat","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"402":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID project (publikasi)"}],"get":{"summary":"Detail project + scene","responses":{"200":{"description":"OK"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"summary":"Hapus project (link AR mati)","responses":{"204":{"description":"Terhapus"}}}},"/projects/{id}/assets/{assetId}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID project (publikasi)"},{"name":"assetId","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]{4,32}$"}}],"put":{"summary":"Upload / ganti aset (body = file mentah, set Content-Type)","requestBody":{"content":{"*/*":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"OK"},"402":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{id}/scene":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID project (publikasi)"}],"put":{"summary":"Simpan scene → project langsung live","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Scene"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{id}/stats":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"ID project (publikasi)"}],"get":{"summary":"Statistik dibuka, scan per target, tap per objek, per hari","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}}}}}}}