Help Using the API

Kissell

I've written some Amazon Echo integration with Repetier Server...  so from the living room I can say "Alexa, ask 3D printer for it's current status" and it'll return "The 3D Printer named Home Office is currently powered and online and is 63% done printing a 3D model named Bishop Chess Piece".  This allows me to check on the printer without having to walk back to my home office and without having to find my phone or computer... in fact I can get a status update without moving my hands and eyes away from playing a video game.

I was able to get that Alexa integration to work by using the Repetier Server API at /printer/list/<printer_name> with the api key for my user.  

http://repetier-server.example.com:3344/printer/list/Home_Office?apikey=abaad32-bbbb-cccc-aaaa-asdadsfasdfas

Anyway, that works great, but now I want to do more.  I'd like to be able to get a list of items available to print and start printing one, and be able to disable the motors or move the axis by voice...  and to do that I need to know how to do that in the API, but nothing I've tried works.  

I found this documentation, but it has no examples: http://www.repetier-server.com/manuals/programming/API/index.html

I tried to follow it, like by doing this to send the extruder to the home location (G28): http://repetier-server.example.com:3344/printer/send/Home_Office?cmd=G28&apikey=abaad32-bbbb-cccc-aaaa-asdadsfasdfas

But unfortunately it won't move with that...  

Can anyone help me figure out how to use the API to send gcode commands, list available models, and start printing one?

Repetier

What you are trying does not work as it is not a legal command like list. There are 2 kinds of commands. The one with simple get and websocket commands that require a connection to a authenticated websocket. What you want is the send command from the websocket.

There is a undocumented way to call websocket commands as single web get:

http://localhost:8080/printer/api/DeltaTest?apikey=c22286f3-867c-4c08-88b7-a0d9876542b5&a=stateList&data={}

http://localhost:3344/printer/api/<slug>?apikey=<key>&;a=<command>&data=<json object with data>

The only thing you can not get this way is event data produced on the server side.