Update API Docs for tips.json

Make sure the `curl` code example works and mention a couple of the gotchyas.