Zoho Creator API docs need (serious) work

Zoho Creator API docs need (serious) work

Hi all.

A few things that have caused serious wasted time and frustration for a new user.

First, the Creator API requires a "ticket" value. As far as I can tell, there is _no_ mention of how to obtain the ticket value in the docs. I found two posts in this forum with some sample code, but without those posts I have no idea how I would have ever been able to discover the URL to get a ticket value.

Second, the docs for the API are pretty aggravating. For example, the  Update Record - REST API - POST Method page.
  • Is the Request URL plain or does it include the apikey and ticket? Because the example includes it in the form's action, but if you do that you'll get an HTML error page (not XML/JSON/CSV, which I would expect with an API call).
  • The Request URLs are htpp://? Obviously a minor typo but kind of telling.
  • It's "criteria" not "Criteria". Again, the example code has it wrong, and having a capital C causes an HTML error page to be returned.
Zoho Creator looks to be very interesting, but the API docs need somebody to go through them to ensure they actually work and don't cause errors. Doesn't exactly inspire confidence in the product as is. If it was publicly editable I'd correct it and save others the trouble, but it doesn't appear to be (right?).