Skip to content
ESP3D Logo ESP3D Ecosystem

Web Handlers

Web Handlers

Section titled “Web Handlers”

The embedded HTTP server exposes the following endpoints. All paths are relative to the device IP (e.g., http://192.168.1.100/).

Static & System

Section titled “Static & System”
MethodPathDescription
GET/Serves the embedded WebUI (index.html.gz)
GET/favicon.icoDevice favicon
GET/description.xmlSSDP description XML

Commands & Config

Section titled “Commands & Config”
MethodPathDescription
GET/command?cmd=<command>Execute an ESP command (e.g., [ESP100])
GET/configServe raw esp3dcnf.ini from flash

Filesystem

Section titled “Filesystem”
MethodPathDescription
GET/files?action=list&path=<path>List flash filesystem
POST/filesUpload file(s) to flash (multipart)
GET/sdfiles?action=list&path=<path>List SD card
POST/sdfilesUpload file(s) to SD (multipart)

Actions supported on /files and /sdfiles:

  • list — List directory contents
  • delete — Delete a file
  • deletedir — Delete a directory
  • createdir — Create a directory

Authentication

Section titled “Authentication”
MethodPathDescription
POST/loginLogin with USER + PASSWORD + SUBMIT=yes

Camera

Section titled “Camera”
MethodPathDescription
GET/snapCapture a camera frame (JPEG)

Firmware Update

Section titled “Firmware Update”
MethodPathDescription
POST/updatefwUpload firmware binary for OTA update

WebSocket

Section titled “WebSocket”
MethodPathDescription
GET/wsTerminal/WebUI WebSocket (subprotocol webui-v3)
GET/wsdataData/tools WebSocket (subprotocol esp3d-v1)

WebDAV

Section titled “WebDAV”
MethodPathDescription
GET/webdav/?*Read file/directory
PUT/webdav/?*Write file
DELETE/webdav/?*Delete file/directory
MKCOL/webdav/?*Create directory
PROPFIND/webdav/?*List properties
OPTIONS/webdav/?*CORS/options
HEAD/webdav/?*Check existence

Error handling

Section titled “Error handling”
  • 404 — file_not_found handler returns a generic error page
  • 401 — not_authenticated handler triggers login flow