From 90a389870f87ee9852a8553c158446a11748a918 Mon Sep 17 00:00:00 2001
From: Borys Kabakov <b.a.kabakov@gmail.com>
Date: Thu, 5 Oct 2023 19:51:27 +0300
Subject: [PATCH] Update signal-cli-jsonrpc.5.adoc

Added python example for HTTP
---
 man/signal-cli-jsonrpc.5.adoc | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/man/signal-cli-jsonrpc.5.adoc b/man/signal-cli-jsonrpc.5.adoc
index ad9cb538..b947c0b5 100644
--- a/man/signal-cli-jsonrpc.5.adoc
+++ b/man/signal-cli-jsonrpc.5.adoc
@@ -150,6 +150,33 @@ REQUEST: `{"jsonrpc":"2.0"}`
 
 RESPONSE: `{"jsonrpc":"2.0","error":{"code":-32600,"message":"method field must be set","data":null},"id":null}`
 
+=== Python examples
+
+==== HTTP
+
+Let's suppose, the daemon was started like that: `signal-cli -a ACCOUNT daemon --http 'localhost:8000'`
+
+Then minimal example to interact with it will be:
+```python
+import requests
+import random
+
+# 'id' must be or you'll get '201' answer
+x = {"jsonrpc": "2.0", "method": "listGroups", "id": random.randint(1, 999)}
+
+# '/api/v1/rpc' is a undocumented but obligatory part of path to API
+response = requests.post("http://localhost:8000/api/v1/rpc", json=x)
+response.json()
+```
+
+==== Websockets
+
+I failed to achieve any kind of responce with `websockets`
+
+==== TCP
+
+I failed to achieve any kind of responce with `socket` and connection always brakes with `zmq`
+
 == Authors
 
 Maintained by AsamK <asamk@gmx.de>, who is assisted by other open source contributors.