SipSettingsApi

Version 13 (Adrian Georgescu, 09/23/2009 04:11 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 8 Adrian Georgescu
Is possible read and write various SIP account settings by making one shot HTTP requests. When you access the [http://x.sip2sip.info SIP settings page] the server prompts for the SIP account credentials which are then associated with a web session. 
6 1 Adrian Georgescu
7 8 Adrian Georgescu
To perform one shot HTTP requests to access this API directly you must use a TLS client certificate to authorize the request, there is no long-lived web session.
8 8 Adrian Georgescu
9 1 Adrian Georgescu
== API address ==
10 1 Adrian Georgescu
11 1 Adrian Georgescu
To access the API the HTTP client must connect to the following address:
12 1 Adrian Georgescu
13 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml
14 1 Adrian Georgescu
 
15 1 Adrian Georgescu
== Client 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 1 Adrian Georgescu
 * user@domain.crt format can be use by command line tools like curl 
20 6 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 3 Adrian Georgescu
curl -k -E user@domain.crt https://blink.sipthor.net/settings.phtml?export=1&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 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=enum
37 1 Adrian Georgescu
}}}
38 1 Adrian Georgescu
 1. Return the SIP aliases:
39 1 Adrian Georgescu
{{{
40 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=aliases
41 1 Adrian Georgescu
}}}
42 1 Adrian Georgescu
 1. Return the ENUM numbers:
43 1 Adrian Georgescu
{{{
44 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=enum
45 1 Adrian Georgescu
}}}
46 4 Adrian Georgescu
 1. Return the last incoming and outgoing calls:
47 4 Adrian Georgescu
{{{
48 4 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=calls
49 4 Adrian Georgescu
}}}
50 1 Adrian Georgescu
 1. Return the prepaid balance and active prepaid calls:
51 1 Adrian Georgescu
{{{
52 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=prepaid
53 1 Adrian Georgescu
}}}
54 1 Adrian Georgescu
 1. Return the history of prepaid balance:
55 1 Adrian Georgescu
{{{
56 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=balance_history
57 1 Adrian Georgescu
}}}
58 1 Adrian Georgescu
 1. Return the curent monthly usage:
59 1 Adrian Georgescu
{{{
60 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=monthly_usage
61 1 Adrian Georgescu
}}}
62 1 Adrian Georgescu
 1. Return the list of diversions:
63 1 Adrian Georgescu
{{{
64 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=diversions
65 1 Adrian Georgescu
}}}
66 1 Adrian Georgescu
 1. Return the list of accept rules:
67 1 Adrian Georgescu
{{{
68 12 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=accept
69 1 Adrian Georgescu
}}}
70 1 Adrian Georgescu
 1. Return the list of reject rules:
71 1 Adrian Georgescu
{{{
72 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=reject
73 1 Adrian Georgescu
}}}
74 1 Adrian Georgescu
 1. Return the voicemail settings:
75 1 Adrian Georgescu
{{{
76 1 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=voicemail
77 1 Adrian Georgescu
}}}
78 9 Adrian Georgescu
 1. Enabled Do Not Disturb
79 9 Adrian Georgescu
{{{
80 9 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=dnd_on
81 9 Adrian Georgescu
}}}
82 9 Adrian Georgescu
 1. Disable Do Not Disturb
83 9 Adrian Georgescu
{{{
84 9 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=dnd_off
85 9 Adrian Georgescu
}}}
86 9 Adrian Georgescu
 1. Enable Do Not Disturb fro 60 minutes
87 9 Adrian Georgescu
{{{
88 9 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&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 10 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=privacy_on
93 10 Adrian Georgescu
}}}
94 10 Adrian Georgescu
 1. Disable privacy
95 10 Adrian Georgescu
{{{
96 10 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=privacy_off
97 10 Adrian Georgescu
}}}
98 11 Adrian Georgescu
 1. Add an alias to our own account 
99 11 Adrian Georgescu
{{{
100 11 Adrian Georgescu
https://blink.sipthor.net/settings.phtml?export=1&action=add_alias&username=alice
101 11 Adrian Georgescu
}}}