Project

General

Profile

SipSettingsApi » History » Version 50

Adrian Georgescu, 06/09/2012 12:59 PM

1 49 Adrian Georgescu
h1. SIP Account API
2 46 Adrian Georgescu
3 49 Adrian Georgescu
This API can be used from third party applications that wish to interact with the SIP account data stored on the server. Data can be read or modified by calling various functions.
4 46 Adrian Georgescu
5 49 Adrian Georgescu
h2. Server API Address
6 46 Adrian Georgescu
7 1 Adrian Georgescu
To access the API, a client must connect using HTTP protocol to the following address: 
8
9
https://enrollment.sipthor.net/settings.phtml
10
11
The return is encoded using "json":http://json.org.
12
13
h2. API Functions
14 46 Adrian Georgescu
15 50 Adrian Georgescu
The following actions are supported:
16 49 Adrian Georgescu
17
h3. Identity
18 1 Adrian Georgescu
19
# Return identity information:
20
<pre>
21
https://enrollment.sipthor.net/settings.phtml?action=get_identity
22 46 Adrian Georgescu
</pre>
23 50 Adrian Georgescu
24
h3. SIP aliases
25
26 1 Adrian Georgescu
# Return the SIP aliases:
27
<pre>
28
https://enrollment.sipthor.net/settings.phtml?action=get_aliases
29
</pre>
30 50 Adrian Georgescu
31
# Add an alias to our own account 
32
<pre>
33
https://enrollment.sipthor.net/settings.phtml?action=add_alias&username=alice
34
</pre>
35
36
h3. ENUM numbers
37
38 46 Adrian Georgescu
# Return the ENUM numbers:
39 1 Adrian Georgescu
<pre>
40 46 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=get_enum
41
</pre>
42 50 Adrian Georgescu
43
h3. Call history
44
45 46 Adrian Georgescu
# Returns call history:
46 1 Adrian Georgescu
<pre>
47
https://enrollment.sipthor.net/settings.phtml?action=get_history
48 48 Adrian Georgescu
</pre>
49 50 Adrian Georgescu
50
h3. Registered devices
51
52 46 Adrian Georgescu
# Return the list of registered devices
53 47 Adrian Georgescu
<pre>
54 46 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=get_devices
55
</pre>
56 50 Adrian Georgescu
57
h3. Prepaid
58
59 46 Adrian Georgescu
# Return the prepaid balance and active calls:
60
<pre>
61 9 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=get_prepaid
62 46 Adrian Georgescu
</pre>
63
# Return the history of prepaid balance:
64 1 Adrian Georgescu
<pre>
65
https://enrollment.sipthor.net/settings.phtml?action=get_balance_history
66
</pre>
67 46 Adrian Georgescu
# Return the curent monthly usage:
68 10 Adrian Georgescu
<pre>
69 46 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=get_monthly_usage
70
</pre>
71 50 Adrian Georgescu
72
h3. Call forwarding
73
74 1 Adrian Georgescu
# Return the call forwarding settings:
75
<pre>
76
https://enrollment.sipthor.net/settings.phtml?action=get_call_forwarding
77
</pre>
78 50 Adrian Georgescu
79
# Set call forwarding
80
<pre>
81
https://enrollment.sipthor.net/settings.phtml?action=set_call_forwarding&FUNC=target&FBUS=target&...
82
</pre>
83
<pre>
84
FUNC = Forward unconditional all calls
85
FBUS = Forward on Busy
86
FNOL = Forward on Not Online
87
FNOA = Forward on No Answer
88
FUNV = Forward when Not Available based on Accept rules
89
90
Pre-defined keywords for diversion targets:
91
92
<voice-mailbox>
93
<mobile-number>
94
95
</pre>
96
97
h3. Call filtering
98
 
99 46 Adrian Georgescu
# Return the list of accept rules:
100 1 Adrian Georgescu
<pre>
101
https://enrollment.sipthor.net/settings.phtml?action=get_accept_rules
102
</pre>
103
# Return the list of reject rules:
104 46 Adrian Georgescu
<pre>
105
https://enrollment.sipthor.net/settings.phtml?action=get_reject_rules
106
</pre>
107 50 Adrian Georgescu
108
h3. Voicemail settings
109
110 1 Adrian Georgescu
# Return the voicemail settings:
111 46 Adrian Georgescu
<pre>
112
https://enrollment.sipthor.net/settings.phtml?action=get_voicemail
113
</pre>
114 50 Adrian Georgescu
115
h3. Do not disturb
116
117 46 Adrian Georgescu
# Enabled Do Not Disturb
118 1 Adrian Georgescu
<pre>
119 46 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=set_dnd_on
120
</pre>
121
# Disable Do Not Disturb
122 1 Adrian Georgescu
<pre>
123
https://enrollment.sipthor.net/settings.phtml?action=set_dnd_off
124
</pre>
125
# Enable Do Not Disturb for 60 minutes
126 46 Adrian Georgescu
<pre>
127
https://enrollment.sipthor.net/settings.phtml?action=set_dnd_on&duration=60
128 1 Adrian Georgescu
</pre>
129 50 Adrian Georgescu
130
h3. Privacy
131
132 1 Adrian Georgescu
# Enabled privacy (hide Caller Id for outgoing calls)
133
<pre>
134
https://enrollment.sipthor.net/settings.phtml?action=set_privacy_on
135
</pre>
136
# Disable privacy
137
<pre>
138
https://enrollment.sipthor.net/settings.phtml?action=set_privacy_off
139 46 Adrian Georgescu
</pre>