From cff61605fb7260ab60d1abd4e295b71a533869ac Mon Sep 17 00:00:00 2001 From: Damien Date: Thu, 22 Jul 2021 00:40:40 +0200 Subject: docs : make modifications to all md files to make them compatible with mkdocs all markdown files must have a single H1 heading at the top. Signed-off-by: Damien Martin Update CNAME --- docs/API_Server.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) (limited to 'docs/API_Server.md') diff --git a/docs/API_Server.md b/docs/API_Server.md index 6e43ce3e..1ccb6d91 100644 --- a/docs/API_Server.md +++ b/docs/API_Server.md @@ -1,9 +1,11 @@ +# API server + This document describes Klipper's Application Programmer Interface (API). This interface enables external applications to query and control the Klipper host software. Enabling the API socket -======================= +----------------------- In order to use the API server, the klippy.py host software must be started with the `-a` parameter. For example: @@ -16,7 +18,7 @@ can then open a connection on that socket and send commands to Klipper. Request format -============== +-------------- Messages sent and received on the socket are JSON encoded strings terminated by an ASCII 0x03 character: @@ -37,7 +39,7 @@ terminator when transmitting a request. (The Klipper API server does not have a newline requirement.) API Protocol -============ +------------ The command protocol used on the communication socket is inspired by [json-rpc](https://www.jsonrpc.org/). @@ -91,7 +93,7 @@ respect to responses from other requests. A JSON request will never pause the processing of future JSON requests. Subscriptions -============= +------------- Some Klipper "endpoint" requests allow one to "subscribe" to future asynchronous update messages. @@ -119,7 +121,7 @@ send that template. If a "response_template" field is not provided then it defaults to an empty dictionary (`{}`). Available "endpoints" -===================== +--------------------- By convention, Klipper "endpoints" are of the form `/`. When making a request to an "endpoint", -- cgit v1.2.3-70-g09d2