Create Poll REST Endpoint

URLs

POST api.ashx/v2/poll.xml (or .json)

Request Parameters

Name	Type	Description	Location	Required	Default
Question	`string`	The poll question.	Request Body	Required
ContentUrl	`string`	A url that this poll should be associated to in a third party site.	Request Body	Required
Description	`string`	A brief description of the poll.	Request Body	Optional
ExpirationDate	`DateTime`	The date the poll expires, if desired.	Request Body	Optional
ShowResults	`string`	Specifies when votes should be available for viewing. Valid options are 'Always','AfterExpiration', and 'AfterVote'. The default is 'Always'.	Request Body	Optional	Always
Options	`string`	The poll options specified as individual entries in the format _Option_I = VALUE, where I in the option statement is a positive value that indicates the index or position and VALUE is the displayed text.	Request Body	Required

Example Requests

C# REST SDK

This example uses the REST SDK to access the Community REST API within a .Net C# application. In the example, USER_NAME is the user name of the effective user for the request and OAUTH_CLIENT_ID and OAUTH_SECRET are the OAuth client ID and secret, respectively, associated to this application as configured in Administration > Integration > OAuth Clients with the "Client Credentials" grant type enabled. See the documentation for the REST SDK for more details about installation, configuration, and usage options.

var host = new ClientCredentialsRestHost("USER_NAME", "https://mysite.com/", "OAUTH_CLIENT_ID", "OAUTH_SECRET");
var response = host.PostToDynamic(2, "poll.json", false, new RestPostOptions {
	PostParameters = new System.Collections.Specialized.NameValueCollection {
		{ "Question", "question" },
		{ "ContentUrl", "contenturl" },
		{ "Options", "options" }
	}
});

Widget Javascript

This example uses the rest JavaScript API to access the Community REST API within the Community web UI. When accessing the REST API through the javascript API, the effective user is the current contextual user of the web interface.

jQuery.telligent.evolution.post({
	url: jQuery.telligent.evolution.site.getBaseUrl() + 'api.ashx/v2/poll.json',
	data: { 
		'Question': 'question',
		'ContentUrl': 'contenturl',
		'Options': 'options'
	},
	success: function(response) {

	}
});

cURL

This example uses the cURL command-line HTTP utility. ENCODED_TOKEN in the example is the base64-encoded concatenation of the user's API key (created from the user's profile), a colon (:), and the user's user name. Learn more about using the REST API.

curl -H "Rest-User-Token: ENCODED_TOKEN" -d "Question=question&ContentUrl=contenturl&Options=options" -X POST https://mysite.com/api.ashx/v2/poll.xml

Recommended