wsa-webdav/docs/webdav-protocol.md

WebDAV Protocol Reference

WSA WebDev implements the WebDAV (Web Distributed Authoring and Versioning) protocol.

Supported Methods

Method	Description
OPTIONS	Get supported methods and features
GET	Download a file
PUT	Upload a file
DELETE	Delete a file or folder
MKCOL	Create a folder
COPY	Copy a file or folder
MOVE	Move/rename a file or folder
PROPFIND	Get file/folder properties
PROPPATCH	Set file/folder properties
LOCK	Lock a file
UNLOCK	Unlock a file

WebDAV URL Structure

http://127.0.0.1:8088/
├── files/          # User storage (/storage/emulated/0)
│   ├── Download/
│   ├── DCIM/
│   └── ...
└── root/           # Root filesystem (root mode only)
    ├── data/
    ├── system/
    └── ...

Examples

List Directory (PROPFIND)

curl -X PROPFIND http://127.0.0.1:8088/files/ \
  -H "Depth: 1"

Download File (GET)

curl http://127.0.0.1:8088/files/Download/document.pdf \
  -o document.pdf

Upload File (PUT)

curl -X PUT http://127.0.0.1:8088/files/Download/newfile.txt \
  -d "Hello World"

Create Folder (MKCOL)

curl -X MKCOL http://127.0.0.1:8088/files/Download/NewFolder

Delete (DELETE)

curl -X DELETE http://127.0.0.1:8088/files/Download/oldfile.txt

Copy (COPY)

curl -X COPY http://127.0.0.1:8088/files/Download/source.txt \
  -H "Destination: /files/Download/dest.txt"

Move (MOVE)

curl -X MOVE http://127.0.0.1:8088/files/Download/oldname.txt \
  -H "Destination: /files/Download/newname.txt"

Client Compatibility

The WebDAV server is compatible with:

• Windows Explorer (WebClient service)
• macOS Finder
• Cyberduck
• WinSCP
• RaiDrive
• Most WebDAV clients

Limitations

• No HTTPS support (local use only)
• No authentication (anonymous access)
• No partial content (Range) requests
• Limited LOCK/UNLOCK implementation