[Poiesis]

Two things that jumped out at me:

1. No "special characters" allowed in passwords when creating an account. 2. ...where's the REST API? I've "added a service" (TTS), but I have to write a webapp to expose it over HTTP? It sure is a different experience than your typical API documentation.

[jsstylos]

1. This is good feedback, thanks. 2. The rest API docs are at https://www.ibm.com/smarterplanet/us/en/ibmwatson/developerc... You can call the service directly, though the samples show using an http webapp as a proxy to avoid exposing private service credentials. We're still working on the documentation, so feedback is helpful here. What other service REST API docs do you like, just out of curiosity? What are the features that makes that documentation useful?

[aroopPandya]

take a look @ https://www.ibm.com/smarterplanet/us/en/ibmwatson/developerc.... There is also doc link once you click on the service you have bounded. There are samples in java and nodejs. (samples coming soon in github)

[Poiesis]

I did indeed take a look at the docs. That's why I commented. If there's documentation of REST end points, it's not obvious to me. Maybe someone else will point out what I'm missing.

As far as I can tell, most of the documentation essentially begins, "First, deploy a web app on our platform". Which is fine I guess, but isn't nearly as simple as the HTTP APIs you see from many other recent SaaS providers. As least for me, I'm pretty unlikely to jump through those hoops. Maybe others will be different.

Edit: All the way down on the bottom of the documentation page, past the research references, there's a link to HTTP API documentation--literally the last link on the page.