Settings API¶

This API can be used from third party applications that wish to interact with the SIP account settings. Data can be read or modified by calling various functions.

API Address¶

To access the API, a client must connect using HTTP protocol to the following address:

https://enrollment.sipthor.net/settings.phtml

The return is encoded using json.

API Functions¶

You can test the following API commands by using the curl command line utility as follows:

curl https://enrollment.sipthor.net/settings.phtml?action=get_identity

The following actions are supported:

1. Return identity information:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_identity
   

2. Return the SIP aliases:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_aliases
   

3. Return the ENUM numbers:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_enum
   

4. Returns call history:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_history
   

5. Return the list of registered devices
   

   https://enrollment.sipthor.net/settings.phtml?action=get_devices
   

6. Return the prepaid balance and active calls:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_prepaid
   

7. Return the history of prepaid balance:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_balance_history
   

8. Return the curent monthly usage:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_monthly_usage
   

9. Return the call forwarding settings:
   

   https://enrollment.sipthor.net/settings.phtml?action=get_call_forwarding
   

10. Return the list of accept rules:
    

    https://enrollment.sipthor.net/settings.phtml?action=get_accept_rules
    

11. Return the list of reject rules:
    

    https://enrollment.sipthor.net/settings.phtml?action=get_reject_rules
    

12. Return the voicemail settings:
    

    https://enrollment.sipthor.net/settings.phtml?action=get_voicemail
    

13. Enabled Do Not Disturb
    

    https://enrollment.sipthor.net/settings.phtml?action=set_dnd_on
    

14. Disable Do Not Disturb
    

    https://enrollment.sipthor.net/settings.phtml?action=set_dnd_off
    

15. Enable Do Not Disturb for 60 minutes
    

    https://enrollment.sipthor.net/settings.phtml?action=set_dnd_on&duration=60
    

16. Enabled privacy (hide Caller Id for outgoing calls)
    

    https://enrollment.sipthor.net/settings.phtml?action=set_privacy_on
    

17. Disable privacy
    

    https://enrollment.sipthor.net/settings.phtml?action=set_privacy_off
    

18. Add an alias to our own account
    

    https://enrollment.sipthor.net/settings.phtml?action=add_alias&username=alice
    

19. Set call forwarding
    

    https://enrollment.sipthor.net/settings.phtml?action=set_call_forwarding&FUNC=target&FBUS=target&...
    

    
    

    FUNC = Forward unconditional all calls
    FBUS = Forward on Busy
    FNOL = Forward on Not Online
    FNOA = Forward on No Answer
    FUNV = Forward when Not Available based on Accept rules
    
    Pre-defined keywords for diversion targets:
    
    <voice-mailbox>
    <mobile-number>