Basic request:

PUT https://{APIDOMAIN}/api-v1/survey/next

The survey/next method provides three distinct phases of idempotent functionality:

1. Preview and prepare the assigned survey for the designated user
2. Step through 78 paired statements of a survey
3. Deliver the resulting report

In all, there are 80 states in a survey – from presenting an initial “get ready”, through the 78 paired choice statements, to delivery of the report.

During each of these states, a single, common, restful PUT survey/next can be used (with different parameters) for each step.

The method is idempotent because, once the application state advances as a result of a given PUT survey/next it will not change state again until the correct, next set of parameters are provided – no matter how many times the method is called.