@app.get("/data") def read(ref: str, range: str = Header(None)): path = resolve_ref(ref) if not path.is_file(): raise HTTPException(404) # Range handling omitted for brevity return FileResponse(path)
Author: AI Research Unit Version: 1.0 Date: 2026-04-14 Abstract The CS3 (Content Storage as a Service) specification defines a rich API for file synchronization, sharing, and collaboration. However, many implementers and integrators find the full stack complex for edge cases: embedded systems, lightweight microservices, or high-throughput pipelines. This paper presents CS3 Raw — a minimal subset of CS3 focusing on raw binary operations (stat, read, write, delete, list) over HTTP. We provide a practical specification, reference implementation patterns, and benchmarks showing near-filesystem latency with cloud scalability. 1. Introduction CS3 (often associated with projects like Reva, CERNBox, and ownCloud Infinite Scale) defines a gRPC-based API for managing content across heterogeneous storage systems. The full CS3 API includes sharing, public links, metadata dictionaries, versioning, workflows, and garbage collection. cs3 raw
@app.get("/stat") def stat(ref: str): path = resolve_ref(ref) if not path.exists(): raise HTTPException(404) stat = path.stat() return "size": stat.st_size, "mtime": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime(stat.st_mtime)), "etag": f""stat.st_mtime-stat.st_size"", "type": "directory" if path.is_dir() else "file" The full CS3 API includes sharing, public links,
GET /stat?ref=id:123e4567-e89b-12d3-a456-426614174000 : The full CS3 API includes sharing