Need help to undertand Wazo Rest API

English Installation/Configuration
1

Hi All,

I am learning Wazo Platform. Already installed Wazo Platform with WebUI on VirtualBox running Debian 11. My host is Ubuntu 24.04.1 LTS.

I have configured the Wazo Platform through WebUI. Currently able to do voice and video call between two soft phone, also voice and video call from Fanvil doorbell to soft phone.

So far so good. With this progress, I am started to exploring Wazo Platform Rest API. Using API console and curl, I tried some of the API messages. However there are few things that I need help to get around my head. I want to understand the platform better.

I wish experience users could help me with below questions. Hope you don’t mind with the long questions:

  1. Comparing user creation between these two endpoints: POST /users/register and POST /users,
    a. What is the purpose (or the difference) between the the two endpoints?
    b. Does POST /users/register endpoint is actually used for creating tenant?

    I created a user using both endpoints, here’s the observation:

   After created user with endpoint /users:
   * Able to retrieved the created user on get user list (endpoint: /users)
   * Able to generate token with the created user
   
   After created user with endpoint /users/register:
   * Created user doesn't appear on get user list (endpoint: /users)
   * Created user appear on get tenant list (endpoint: /tenants)
   * Created user appear on web-ui/Global Settings/tenants
   * Able to generate token with the created user

  1. What is domain names in tenant creation (endpoint: POST /tenants)? The API described: A list containing human readeable unique domain names, associated with a specific tenant.
    a. If domain name is ip address/network domain name, why a tenant may have multiple domain names?
    b. If not, please elaborate what is the domain name on this endpoint body?

  2. What’s the proper practice to create new tenant: new tenant has ‘master’ uuid as parent or new tenant has its own uuid as parent?
    a. Please elaborate why the chosen practice is better, e.g: pro and cons between the two practice
    b. In what scenario we want new tenant has ‘master’ as parent?
    c. In what scenario we want new tenant use its own uuid as parent?

  3. I noticed Wazo Platform support many devices (with plugin). I have Fanvil i66 doorbell which is not listed on the supported device. I tested to created user and line for the doorbell without adding the doorbell to the devices list. I made a call to soft phone and it worked flawlessly. Working for both voice call and video call.
    a. Any specific purpose of adding the doorbell to device list?
    b. Is it acceptable practice to register the doorbell as user instead of device? any contra if I do this?