Curl improvements

This new release should improve ease of use by allowing the following:

• change the cURL options
• easier changing of the service URL's
• updated docs

Also the getById and getByIds now check for sane id formatting before excuting a call to prevent superfluous network traffic,