SipSettingsApi

Version 29 (Adrian Georgescu, 09/26/2009 12:37 pm)

1 1 Adrian Georgescu
= SIP Settings API =
2 1 Adrian Georgescu
 
3 1 Adrian Georgescu
[[TOC(WikiStart, Sip*, depth=3)]]
4 1 Adrian Georgescu
5 1 Adrian Georgescu
== API address ==
6 1 Adrian Georgescu
7 20 Adrian Georgescu
To access the API, a client must connect using HTTP protocol to the following address: 
8 1 Adrian Georgescu
9 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml
10 19 Adrian Georgescu
11 20 Adrian Georgescu
To be authorized, the client must use a TLS client certificate, this certificate can be retrieved in the Info tab of the web page for the SIP account settings.
12 28 Adrian Georgescu
13 23 Adrian Georgescu
The return is encoded using [http://json.org json].
14 23 Adrian Georgescu
15 22 Adrian Georgescu
== TLS Certificate ==
16 1 Adrian Georgescu
17 13 Adrian Georgescu
Use the web settings page and navigate to the Info tab. Download the TLS certificate in the format supported by your HTTP client. 
18 1 Adrian Georgescu
19 14 Adrian Georgescu
 * !user@domain.crt format can be use by command line tools like curl 
20 14 Adrian Georgescu
 * !user@domain.p12 format can be imported in web browsers
21 5 Adrian Georgescu
22 7 Adrian Georgescu
The .p12 file contains the same certificate stored in a way that can be loaded by web browsers like Safari on MacOSX or Firefox.  To unlock the .p12 file you must use the password for your SIP account.
23 1 Adrian Georgescu
24 1 Adrian Georgescu
== API calls ==
25 1 Adrian Georgescu
26 1 Adrian Georgescu
You can test all API commands by using the '''curl''' command line utility as follows:
27 1 Adrian Georgescu
28 1 Adrian Georgescu
{{{
29 29 Adrian Georgescu
curl -k -E user@domain.crt https://enrollment.sipthor.net/settings.phtml?action=name
30 1 Adrian Georgescu
}}}
31 3 Adrian Georgescu
32 3 Adrian Georgescu
The following actions are supported:
33 1 Adrian Georgescu
34 1 Adrian Georgescu
 1. Return the account information:
35 1 Adrian Georgescu
{{{
36 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=enum
37 1 Adrian Georgescu
}}}
38 1 Adrian Georgescu
 1. Return the SIP aliases:
39 1 Adrian Georgescu
{{{
40 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=aliases
41 1 Adrian Georgescu
}}}
42 1 Adrian Georgescu
 1. Return the ENUM numbers:
43 1 Adrian Georgescu
{{{
44 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=enum
45 1 Adrian Georgescu
}}}
46 4 Adrian Georgescu
 1. Return the last incoming and outgoing calls:
47 4 Adrian Georgescu
{{{
48 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=calls
49 4 Adrian Georgescu
}}}
50 1 Adrian Georgescu
 1. Return the prepaid balance and active prepaid calls:
51 1 Adrian Georgescu
{{{
52 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=prepaid
53 1 Adrian Georgescu
}}}
54 1 Adrian Georgescu
 1. Return the history of prepaid balance:
55 1 Adrian Georgescu
{{{
56 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=balance_history
57 1 Adrian Georgescu
}}}
58 1 Adrian Georgescu
 1. Return the curent monthly usage:
59 1 Adrian Georgescu
{{{
60 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=monthly_usage
61 1 Adrian Georgescu
}}}
62 1 Adrian Georgescu
 1. Return the list of diversions:
63 1 Adrian Georgescu
{{{
64 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=diversions
65 1 Adrian Georgescu
}}}
66 1 Adrian Georgescu
 1. Return the list of accept rules:
67 1 Adrian Georgescu
{{{
68 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=accept
69 1 Adrian Georgescu
}}}
70 1 Adrian Georgescu
 1. Return the list of reject rules:
71 1 Adrian Georgescu
{{{
72 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=reject
73 1 Adrian Georgescu
}}}
74 1 Adrian Georgescu
 1. Return the voicemail settings:
75 1 Adrian Georgescu
{{{
76 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=voicemail
77 1 Adrian Georgescu
}}}
78 9 Adrian Georgescu
 1. Enabled Do Not Disturb
79 9 Adrian Georgescu
{{{
80 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=dnd_on
81 9 Adrian Georgescu
}}}
82 9 Adrian Georgescu
 1. Disable Do Not Disturb
83 9 Adrian Georgescu
{{{
84 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=dnd_off
85 9 Adrian Georgescu
}}}
86 17 Adrian Georgescu
 1. Enable Do Not Disturb for 60 minutes
87 9 Adrian Georgescu
{{{
88 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=dnd_on&duration=60
89 9 Adrian Georgescu
}}}
90 10 Adrian Georgescu
 1. Enabled privacy (hide Caller Id for outgoing calls)
91 10 Adrian Georgescu
{{{
92 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=privacy_on
93 10 Adrian Georgescu
}}}
94 10 Adrian Georgescu
 1. Disable privacy
95 10 Adrian Georgescu
{{{
96 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=privacy_off
97 10 Adrian Georgescu
}}}
98 11 Adrian Georgescu
 1. Add an alias to our own account 
99 11 Adrian Georgescu
{{{
100 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=add_alias&username=alice
101 11 Adrian Georgescu
}}}
102 16 Adrian Georgescu
 1. Set diversions
103 16 Adrian Georgescu
{{{
104 29 Adrian Georgescu
https://enrollment.sipthor.net/settings.phtml?action=set_diversions&FUNC=target&FBUS=target&...
105 16 Adrian Georgescu
}}}
106 16 Adrian Georgescu
{{{
107 16 Adrian Georgescu
FUNC = Forward unconditional all calls
108 16 Adrian Georgescu
FBUS = Forward on Busy
109 16 Adrian Georgescu
FNOL = Forward on Not Online
110 16 Adrian Georgescu
FNOA = Forward on No Answer
111 16 Adrian Georgescu
FUNV = Forward when Not Available based on Accept rules
112 25 Adrian Georgescu
113 27 Adrian Georgescu
Pre-defined keywords for diversion targets:
114 26 Adrian Georgescu
115 24 Adrian Georgescu
<voice-mailbox>
116 25 Adrian Georgescu
<mobile-number>
117 25 Adrian Georgescu
118 24 Adrian Georgescu
}}}