Watson Tone Analyzer API call in Bluemix (beta plan)
Hello,
it appears that the "experimental" plan in Bluemix was recently replaced with the "beta" plan. I've created a new service instance thinking that this would take care of a migration for an existing app, but calls to https://gateway.watsonplatform.net/tone-analyzer-beta/api/v1/tone return "code":400,"error":"Unsupported API version".
The VCAP entry looks as follows: { "tone_analyzer": [ { "name": "tone analyzer", "label": "tone_analyzer", "plan": "beta", "credentials": { "url": "https://gateway.watsonplatform.net/tone-analyzer-beta/api", "username": "myname", "password": "mynameismypassword" } } ] }
The documentation (https://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/doc/tone-analyzer/output.shtml) has not been updated yet to reflect any end-point changes. It still lists POST /tone-analyzer-experimental/api/v1/tone as endpoint.
What am I missing? Please advise.
With the beta plan, we are releasing v3 of the tone API. There are significant changes between v1 and v3. Hence, the beta plan no longer support v1. The new documentation will be out in a week's time.
In the meantime if you want to see the v3 changes, you can use the following endpoint - https://gateway.watsonplatform.net/tone-analyzer-beta/api/v3/tone?version=2015-02-11
Thanks, this information got me over the first hump! Unless I am misinterpreting the doc, API version v1 returned results for the entire (input) text, whereas v3 returns results for each sentence in the text. Does API version v3 also provide the means to retrieve aggregated results for the entire text or does the client have to perform the aggregation?
Hello - here is a link to the doc that has the difference between beta and experimental - http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/doc/tone-analyzer/updates.shtml
Here is a link to the API reference which give full input and output details of the beta release - http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/tone-analyzer/api/v3/
The link you have is an outdated link.
Great, thanks! The Link I pasted came from the Bluemix website.