| ||Ask HN: Restless to RESTful - are we doing it right?|
1 point by faxman 1987 days ago | hide | past | web | favorite |
|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.
| Apply to YC