RADIUSdesk

Trace:

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
user_guide:user_registration_api [2021/02/08 09:18] – [API] adminuser_guide:user_registration_api [2021/02/08 10:14] (current) – [Finding the login_page_id] admin
Line 9: Line 9:
  
 ===== API ===== ===== API =====
 +==== API URL ====
 +  * We assume the FQDN of the RADIUSdesk server is **hotspot.radiusdesk.com**. Please adapt accordingly.
 +  * http://hotspot.radiusdesk.com/cake3/rd_cake/register-users/new-permanent-user.json
 +
 +==== Items included in the POST ====
 +
   * Let us take a look at the items submitted to the back-end when a user registers and then discuss important items in that list.   * Let us take a look at the items submitted to the back-end when a user registers and then discuss important items in that list.
  
 <code javascript> <code javascript>
 { {
- "mac": "28-D2-44-20-04-8D",+ "mac": "28-D2-44-20-AA-00",
  "login_page": "demo1",  "login_page": "demo1",
  "login_page_id": "1",  "login_page_id": "1",
Line 24: Line 30:
 </code> </code>
  
 +^ Item      ^ Typical Value       ^ Comment          ^
 +| mac    | 28-D2-44-20-AA-00     | Mandatory if the **One user registration per device** is selected     |
 +| login_page    | demo1     | Optional - Not required but may be useful to know which login page you work with  |
 +| login_page_id  | 1     | The ID is kept in a hidden column under the Dynamic Details Grid  |
 +| name    | Dirk     |   |
 +| surname    | van der Walt     |   |
 +| username    |  dirkvanderwalt@radiusdesk.com     | We use the email address as the username  |
 +| password    | very$ecu3     |  |
 +| phone    | 0721235555     |  |
 +
 +==== Finding the login_page_id ====
 +  * See the following screenshot to get to the login_page_id
 +
 +{{ :user_guide:login:login_page_id.png?nolink&400 |}}
 +
 +
 +  * The first hidden column contains the value of login_page_id.
 +
 +
 +
 +
 +
 +
 +==== A Word On The MAC Address ====
 +
 +  * The MAC Address is the MAC address from the WiFi interface of the device that the user will connect with to the Captive Portal.
 +  * When we use the login page to do the user registration we can extract it from the detail provided to us by CoovaChilli typically.
 +  * When we create something like a mobile app and want to allow someone to register **without being connected to the Captive Portal**, we can still supply the MAC address of the device using the app.
 +  * Here is some info on how to get it programmatically: https://stackoverflow.com/questions/10831578/how-to-find-mac-address-of-an-android-device-programmatically/13007454
 +
 +==== Reply - Success ====
 +
 +  * This is typically what a successful reply will look like
 <code javascript> <code javascript>
 { {
Line 48: Line 87:
 </code> </code>
  
 +==== Reply - Failure ====
 +  * This is a typical message if someone tries to register twice from the same device
 <code javascript> <code javascript>
 { {
Last modified: 2021/02/08 09:18