Cloud9 HTTP/XML/SS7 GSM System API - HTTP/XML/SS7 GSM System API FAQ

Cloud9 HTTP/XML System API FAQ

Questions:

(1). Why can I not access http://api.wire9.com?

(2). When I pass a HTTP string to Cloud9's HTTP server I get an error back but the string contains the correct variables?

(3). When I pass a HTTP string I get an error back saying unknown CARRIER_ID and/or PASSWORD?

(4). When I make a HTTP post and I receive the XML reply back how do I phase through the response to pull back the values?

(5). When I make a HTTP request should I make a POST or Get to the Cloud9 Server?

(6). When I make a HTTP request I receive an XML error back <ERROR></ERROR>. What am I doing wrong?

(7). When Cloud9 sends a HTTP string to my server I note in your documentation that you send to a .asp file but we do not use ASP. Can you send to other script extension types?

(8). Why do some Cloud9 HTTP/XML functions require enablement before I can use them?

(9). I would like to suggest a HTTP/XML function which is currently not available, how do I go around doing this?

Answers:

(1). http://api.wire9.com is protected by Cloud9's firewall. To access this URL you need to let us know the IP address of the machine or machines that will be accessing so we can add your IP's to our system firewall.

(2). Check that the URL string you pass is URLEncoded. URL Encoding replaces unsafe ASCII characters with "%" followed by their hex equivalent. Safe characters are defined in RFC2396. For example a '+' will become '%2B'

(3). This error means that the system can not authenticate your API logon details. Please email support@cloud9-mobile.co.uk and out support team will confirm your API logon details.

(4). This depends on what programming language you are using to read the XML responce back with. Below are some links which should help you:

ASP - http://www.4guysfromrolla.com/webtech/051000-1.shtml

C++ - http://iridia.ulb.ac.be/~fvandenb/tools/xmlParser.html

Cold Fusion - http://coldfusion.sys-con.com/node/41761

Java - http://www.cafeconleche.org/books/xmljava/

Perl - http://articles.techrepublic.com.com/5100-10878_11-5363190.html

PHP - http://www.devpapers.com/article/61

(5). When you make a HTTP request to the Cloud9 server you can do this either by a HTTP POST or GET as both formats are supported.

(6). There could be several reasons for this. Details of the error will be contained within the <ERROR></ERROR> tag. The most likely cause is that you have a variable missing from within the HTTP string or the data within the string is in a in correct format. Check over the online documentation first, if you still can not resolve the problem then we would recommend that you email support@cloud9-mobile.co.uk with a copy of the HTTP string you are sending so our support team can have a look into the error for you.

(7). Cloud9 can send to any extension type. You simply need to tell us what script extension type you are using. Email support@cloud9-mobile.co.uk with your extension details.

(8). Certain Cloud9 HTTP/XML functions require enable meant because if they where enabled by default your users would not be able to make or receive calls. For example if the AUTH_INBOUND_CALL function was enabled and your server wasn't setup to receive this request, every inbound call that our system received we would send a HTTP request over to your server to authorize the call, if your server didn't respond then by default the call would be dropped and your users handset wouldn't ring.

(9). At Cloud9 we are always open to suggestions so if you have an idea for a API function that is currently not available then simply email wishlist@cloud9-mobile.co.uk We can then review your request to see what can be done.

Can't find the solution to your problem? Then please drop our support team a line: support@cloud9-mobile.co.uk