Fixed up the synopsis documentation so it works...

... and added a test of course.

Still a mismatch between the docs and the actual behaviour of the API
with regards to whether or not there is a 'words' array returned in the
regular response section of the JSON response.