API Function: currency
API Function Application: Query Cloud9 exchange rate for Dollar and Euro currencies
API Function Request Type: HTTP Request is sent from your server to our server.
API Function Status: Available as standard
API Function Examples: Click Here to view online examples.


To check the current Cloud9 Dollar and Euro exchange rate simply use the 'currency' function and send a URL string like so:

 

http://api.wire9.com/api.cgi?transaction_id=1001&request_type=currency&carrier_id=1&password=test
&timestamp=2007-03-08%2023:43:43

IMPORTANT: You must URL Encode your HTTP string. URL Encoding replaces unsafe ASCII characters with "%" followed by their hex equivalent. Safe characters are defined in RFC2396. For example a '+' will become '%2B'

 

The URL is made up of the following variables:

URL

http://api.wire9.com/api.cgi

TRANSACTION_ID

The transaction ID your system assigned to the CHECK BALANCE request.

REQUEST_TYPE

This variable must be set to 'currency'.

CARRIER_ID

This variable must contain the carrier ID that has been assigned to you for use with our API. Please contact support@cloud9-mobile.co.uk if you do not have your API carrier ID.

PASSWORD

This variable must contain the password that has been assigned to you for use with our API. Please contact support@cloud9-mobile.co.uk if you do not have your API password.

TIMESTAMP

This variable is set by your system. It should contain a valid date and time in yyyy-mm-dd HH:mm:ss format. This time stamp is used for the API CDR records.

 

Please Note: All of the above variables are required within the HTTP request string.
The currency request will fail if the required variables are not passed in the correct format.

When a valid currency request is made the Cloud9 system will return a standard XML (version 1 tree)
which your system must then phase through and pull out the required data:

 

<?xml version="1.0" ?>

<Wire9_data>

<CURRENCY_Response>

<EURO_RATE>1.43</EURO_RATE>

<EURO_START_DATE>2008-10-29 12:02:23</EURO_START_DATE>

<EURO_END_DATE>2010-10-29 00:00:00</EURO_END_DATE>

<DOLLAR_RATE>1.43</DOLLAR_RATE>

<DOLLAR_START_DATE>2008-10-29 12:02:23</DOLLAR_START_DATE>

<DOLLAR_END_DATE>2010-10-29 00:00:00</DOLLAR_END_DATE>

<REQUEST_STATUS>1</REQUEST_STATUS>

<TIME_STAMP>2007-03-08 23:43:43</TIME_STAMP>

<TRANSACTION_ID>1000</TRANSACTION_ID>

</CURRENCY_Response>

</Wire9_data>


The XML output is made up like so:

EURO_RATE

This variable contains the current Cloud9 Euro rate (so RATE = £1 UK Sterling Pound).

EURO_START_DATE

This variable contains the affective date and time of the Cloud Euro rate.

EURO_END_DATE

This variable contains the Cloud9 Euro rate expiry date and time.

DOLLAR_RATE

This variable contains the current Cloud9 Dollar rate (so RATE = £1 UK Sterling Pound).

DOLLAR_START_DATE

This variable contains the affective date and time of the Cloud9 Dollar rate.

DOLLAR_END_DATE

This variable contains the Cloud9 Dollar rate expiry date and time.

REQUEST_STATUS

This variable will contain the request status responce.
Options: 0 = Request Failed 1 = Request Successful

TIME_STAMP

The returned TIMESTAMP that you passed within the HTTP request string.

TRANSACTION_ID

The transaction ID your system assigned to the IMSI Status request.

 

If our server is unable to process the request or a system error occurs we will send back a formatted XML
error message like so stating what error occurred within the <Error_Message></Error_Message> tag::

 

<? xml version="1.0" ?>

<Error>

 <Error_Message>Error: Unknown user </Error_Message>
</Error>

 

ERROR_MESSAGE

This variable will contain information to why the request could not be processed by our system.

 

Top of page      Email page    Print page

Last Review 29/10/2008 @ 15:10:20

Privacy Statement | HTTP/XML System API © 2010 Cloud9 Mobile International Ltd. All Rights Reserved.