Project

General

Profile

SipSettingsApi » History » Revision 48

Revision 47 (Adrian Georgescu, 06/03/2012 11:24 AM) → Revision 48/68 (Adrian Georgescu, 06/03/2012 11:33 AM)

h1. 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. 


 h2. 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":http://json.org. 


 h2. API Functions 


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

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

 The following actions are supported: 

 # Return identity information: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_identity 
 </pre> 
 # Return the SIP aliases: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_aliases 
 </pre> 
 # Return the ENUM numbers: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_enum 
 </pre> 
 # Returns call history: the list of last calls: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_history 
 </pre> 
 # Return the list of registered devices 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_devices 
 </pre> 
 # Return the prepaid balance and active calls: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_prepaid 
 </pre> 
 # Return the history of prepaid balance: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_balance_history 
 </pre> 
 # Return the curent monthly usage: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_monthly_usage 
 </pre> 
 # Return the call forwarding settings: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_call_forwarding 
 </pre> 
 # Return the list of accept rules: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_accept_rules 
 </pre> 
 # Return the list of reject rules: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_reject_rules 
 </pre> 
 # Return the voicemail settings: 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=get_voicemail 
 </pre> 
 # Enabled Do Not Disturb 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=set_dnd_on 
 </pre> 
 # Disable Do Not Disturb 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=set_dnd_off 
 </pre> 
 # Enable Do Not Disturb for 60 minutes 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=set_dnd_on&duration=60 
 </pre> 
 # Enabled privacy (hide Caller Id for outgoing calls) 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=set_privacy_on 
 </pre> 
 # Disable privacy 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=set_privacy_off 
 </pre> 
 # Add an alias to our own account  
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=add_alias&username=alice 
 </pre> 
 # Set call forwarding 
 <pre> 
 https://enrollment.sipthor.net/settings.phtml?action=set_call_forwarding&FUNC=target&FBUS=target&... 
 </pre> 
 <pre> 
 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> 

 </pre>