go-octoprint

Go library for accessing the OctoPrint's REST API.

Installation

The recommended way to install go-octoprint

go get github.com/mcuadros/go-octoprint

Example

Retrieving the current connection state:

client, _ := NewClient("<octoprint-url>", "<api-key>")

r := octoprint.ConnectionRequest{}
s, err := r.Do(client)
if err != nil {
  log.Error("error requesting connection state: %s", err)
}

fmt.Printf("Connection State: %q\n", s.Current.State)

Retrieving current temperature for bed and extruders:

r := octoprint.StateRequest{}
s, err := r.Do(c)
if err != nil {
	log.Error("error requesting state: %s", err)
}

fmt.Println("Current Temperatures:")
for tool, state := range s.Temperature.Current {
	fmt.Printf("- %s: %.1f°C / %.1f°C\n", tool, state.Actual, state.Target)
}

Implemented Methods

Version Information

• GET /api/version

Apps

• GET /apps/auth
• POST /apps/auth

Connection Operations

• GET /api/connection
• POST /api/connection

File Operations

• GET `/api/files
• GET /api/files/<location>
• POST /api/files/<location>
• GET /api/files/<location>/<filename>
• POST /api/files/<location>/<path> (Only select command)
• DELETE /api/files/<location>/<path>

Job Operations

• POST /api/job
• GET /api/job

Languages

• GET /api/languages
• POST /api/languages
• DELETE /api/languages/<locale>/<pack>

Log file management

• GET /api/logs
• DELETE /api/logs/<filename>

Printer Operations

• GET /api/printer
• POST /api/printer/printhead
• POST /api/printer/tool
• GET /api/printer/tool
• POST /api/printer/bed
• GET /api/printer/bed
• POST /api/printer/sd
• GET /api/printer/sd
• POST /api/printer/command
• GET /api/printer/command/custom (un-documented at REST API)

Printer profile operations

• GET /api/printerprofiles
• POST /api/printerprofiles
• PATCH /api/printerprofiles/<profile>
• DELETE /api/printerprofiles/<profile>

Settings

• GET /api/settings
• POST /api/settings
• POST /api/settings/apikey

Slicing

• GET /api/slicing
• GET /api/slicing/<slicer>/profiles
• GET /api/slicing/<slicer>/profiles/<key>
• PUT /api/slicing/<slicer>/profiles/<key>
• DELETE /api/slicing/<slicer>/profiles/<key>

System

• GET /api/system/commands
• GET /api/system/commands/<source>
• POST /api/system/commands/<source>/<action>

Timelapse

• GET /api/timelapse
• DELETE /api/timelapse/<filename>
• POST /api/timelapse/unrendered/<name>
• DELETE /api/timelapse/unrendered/<name>
• POST /api/timelapse

User

• GET /api/users
• GET /api/users/<username>
• POST /api/users
• PUT /api/users/<username>
• DELETE /api/users/<username>
• PUT /api/users/<username>/password
• GET /api/users/<username>/settings
• PATCH /api/users/<username>/settings
• POST /api/users/<username>/apikey
• DELETE /api/users/<username>/apikey

Util

• POST /api/util/test

Wizard

• GET /setup/wizard
• POST /setup/wizard

License

MIT, see LICENSE