|
** All api calls require member account authentication.
|
|
** To authenticate, pass each JSON request your member email and password as POST parameters.
|
|
API URL: http://www.polladium.com/web_services/api/api.php
|
get_top_polls
|
description
returns a list of top performing polls the authenticated publisher created.
|
method:
post
|
required parameters:
req : get_top_polls
|
optional parameters:
status : will return polls with specified status. [ active, inactive, all ]
limit : will return 20 results if limit not specified
member_api_id : returns true if the specified member_api_id has voted on the poll
|
|
|
get_recent_polls
|
description
returns a list of recent polls the authenticated publisher created.
|
method:
post
|
required parameters:
req : get_recent_polls
|
optional parameters:
status : will return polls with specified status. [ active, inactive, all ]
limit : will return 20 results if limit not specified
member_api_id : returns true if the specified member_api_id has voted on the poll
|
|
|
get_all_polls
|
description
returns a list of all polls the authenticated publisher created.
|
method:
post
|
required parameters:
req : get_all_polls
|
optional parameters:
status : will return polls with specified status. [ active, inactive, all ]
member_api_id : returns true if the specified member_api_id has voted on the poll
|
|
|
get_poll_info
|
description
returns information about the specified poll. polls are uniquely identified by poll_id and location_id.
|
method:
post
|
required parameters:
req : get_poll_info,
poll_id : valid poll_id,
location_id : valid location_id
|
optional parameters:
member_api_id : returns true if the specified member_api_id has voted on the poll
|
|
|
cast_vote
|
description
casts a vote for the specified poll. we recommend setting the member_api_id to the actual member_id on your Website so you can easily associate vote data with your member base.
|
method:
post
|
required parameters:
req : cast_vote,
poll_id : valid poll_id,
location_id : valid location_id,
member_api_id: unique id to reference member,
poll_option_id: option id of vote choice
|
optional parameters:
vox : opinion in 160 characters or less provided by member when voting
|
|
|