Ask HN: Restless to RESTful - are we doing it right?

InterFAX is an online fax service provider which is popular with developers because of its API. Up until now we've only had a SOAP API, and due to popular demand, we're coming out with a REST API. I would appreciate your comments on how we're doing.

The service is documented at http://www.interfax.net/en/dev/rest/reference (this is a deep link; the link hasn't yet been published publicly), where there's also access to a little developer's guide.

The service is live on a pilot server. To play around with the service, register by clicking on any one of the "Get Started" buttons which lead to www.interfax.net/en/dev/register. Because the service is on a pilot server, any live code needs to go to endpoint https://rest-pilot.interfax.net instead of the documented https://rest.interfax.net .

Pre-empting some comments that are likely to be raised:

- Samples for various languages will be released at a later stage. However, cURL and raw HTTP samples will be available for every operation before the API gets released.

- A "Getting Started" page is in the works.

Fire away!