/////////////////////////////////////////
                                    //  Voxbone Web Services Release Note  //
                                    /////////////////////////////////////////


Release Info:
=============

release: v0.1 RC1
Developer: Morsiani Vincent
Company: Voxbone S.A.
support: support-dev@voxbone.com


VoxService v0.1 RC1 (2006-01-16):
=============================

Note:
The Voxbone Web Service has now reached maturity and changed its status to RC1.
While in Release Candidate, we will monitor closely its behaviour and get feedback from early adopters.
We expect the service to be stable within the next two weeks

Web Services Operations:
-------------------------

[updated]Collection<Country> getCountriesList( AuthenticationToken token )
[updated]Collection<AreaCode> getAreaForCountries( AuthenticationToken token, String country_code_a2 )
[added]Collection<DID>buyDIDs( AuthenticationToken token, int countryPhoneCode, int areaCode, int identifier, int quantity, String defaultURI, PurchaseInfo purchaseInfo )
[added]boolean mapDID( AuthenticationToken token, String DIDNumberFormatted, String URI )

Operations Description:
-----------------------

- When using the getAreaCodeForCountry operation, an exception is thrown if the specified area_code_a2 doesn't exist or isn't covered actually.
- An exception is thrown if you entered an invalid username / password ( all operations )
- In order to avoid coma problems, all the prices are expressed in cents


Voxbone SDK (Java):
===================

Requirements:
-------------

- Sun Java SDK installed
- The following jar file in your classpath:
    * activation.jar
    * FastInfoset.jar
    * jaxrpc-api.jar
    * jaxrpc-impl.jar
    * jaxrpc-spi.jar
    * jsr173_api.jar
    * mail.jar
    * saaj-api.jar
    * saaj-impl.jar

Containers:
-----------

[updated]AuthenticationToken
[added]DID


Special Notes:
==============

1)	Because of security issues, we changed the authentication method.
		The old authentication methods were removed and replaced by new ones.
		now we use a SHA1 system ( Secure Hash Algorithm ).
		when creating a hash value, mix your password and a changing value for each request.

2)	In order to use the web service, you have to send an email at support-dev@voxbone.com
		and ask us to authorize your account to use the web service.
		please send us your motivation and why you want to use the service.