API changes to /my/polls and poll JSON requests

[Brad Gessler]

A few API changes just made it in our roadmap, but we don't yet have dates on when these changes will take affect. I'll provide more specifics as we start to know them better.

1. /my/polls.json will have less information

We're going to be trimming back the amount of data that /my/polls.json returns to show just the poll title, results count, and the state of the poll to speed things up for getting poll data. If you want to fetch extended data about the polls, you'll need to fire off a GET request to each poll URL individually.

2. /multiple_choice_polls/:id.json, /free_text_polls/:id.json will show a root key

In an effort to make our JSON API more consistent, we're going to be adding a root key to our poll JSON files.

Today a multiple choice poll JSON request/response looks something like this:

GET /multiple_choice_poll/:id.json => {options: [], title: 'A poll'}

After the API changes they will look like this:

GET /multiple_choice_poll/:id.json => {multiple_choice_poll => {options: [], title: 'A poll'}}