From 29e9b773919df6c1ee2a2c0ca21aff309e0e0cd5 Mon Sep 17 00:00:00 2001 From: Rick Companje Date: Sun, 22 May 2016 00:07:24 +0200 Subject: [PATCH] Update README.md --- README.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index e942899..35bd3e2 100644 --- a/README.md +++ b/README.md @@ -9,11 +9,13 @@ The following image shows a typical doodle3d-connect page. The most common way t ![connect.doodle3d.com](https://cloud.githubusercontent.com/assets/156066/15451030/645fd5ae-1fb0-11e6-9521-e2271c1d2bc5.png) -#Server +#How does it work? ![Diagram of doodle3d-connect](https://cloud.githubusercontent.com/assets/156066/15450961/519baea0-1fad-11e6-9b58-9ca597db0a55.png) + +##Server The Doodle3D connect server has an api with 2 methods: -##list +###list Retrieve a list of connected WiFi-Boxes that are on the same remote IP and that signed-in less than an hour ago. The remote IP is the IP adres you're behind on the internet. Usually when you're on a network all devices on that network have the same remote IP. It returns the following information per WiFi-Box: @@ -26,7 +28,7 @@ data: Sign-in date. Current url: http://connect.doodle3d.com/api/list.php Example url: http://connect.doodle3d.com/api/list.example -##signin +###signin Used to sign-in into the connect system. Requires: @@ -34,7 +36,7 @@ localip: The local IP of the WiFi-Box on the local network. wifiboxid: A custom human readable name to identify the WiFi-Box. From the request it will determine the remote IP and the date. This request will also remove sign-ins from more than an hour ago. -#WiFi-Box +##WiFi-Box The WiFi-Box will perform a scan for WiFi networks, when a known network is available it will join this network. When no known network is found it will become a access point. This means a fresh WiFi-Box will always become a access point. When a WiFi network is joined the WiFi-Box will attempt to Sign-in, when this fails it will retry a couple of times. From then on it will attempt a sign-in every 15 minutes. It also attempt a sign-in when the wifibox id is changed. @@ -42,6 +44,6 @@ The WiFi-Box has a couple of API methods required for the connect system: network/alive. A very simple method that doesn't contain any logic or info. It's just something (Web)App's can query to check whether there is something behind a local IP adres. Similar to a ping. -#(Web)App +##(Web)App (Web)Apps can use the connect system to find WiFi-Boxes on the same network. They continuely query the list api method to retrieve local WiFi-Boxes information. Because the server can't know their current status the (Wep)App should query the alive api method of the WiFi-Boxes. When it get's a valid response the WiFi-Box can be shown to the user. Besides querying the boxes it retrieves through the list api The Web(App) should also continuesly query the alive method of boxes that are already shown. To make this easier for (Wep)App developers we created a JavaScript library that handles this; ConnectAPI.js.