HTTP request
GET https://api.wevoteusa.org/apis/v1/twitterSignInStart (Jump to "Try It Now")
Required Parameters
| Parameter name | Value | Description |
| voter_device_id | string | An 88 character unique identifier linked to a voter record on the server |
| return_url | string | The URL where the browser should be redirected once authenticated. Usually https://wevote.me/settings/account |
| api_key | string (from post, cookie, or get (in that order)) | The unique key provided to any organization using the WeVoteServer APIs |
Response
{
"status": string,
"success": boolean,
"voter_device_id": string (88 characters long),
"twitter_redirect_url": string, (Where twitter wants We Vote to redirect the browser, with variables)
"voter_info_retrieved": boolean, (if handled without redirect, was voter info retrieved from Twitter?)
"switch_accounts": boolean, (Was there an existing account for this Twitter account? If true, a new voter_device_id is returned that links to this other We Vote account.)
}
Response Status Codes
| Code | Description |
| VALID_VOTER_DEVICE_ID_MISSING | Cannot proceed. A valid voter_device_id parameter was not included. |
| VALID_VOTER_ID_MISSING | Cannot proceed. A valid voter_id was not found. |
Try It Now: API Variables
Flow chart showing entire process here: https://docs.google.com/drawings/d/1WdVFsPZl3aLM9wxGuPTW3veqP-5EmZKv36KWjTz5pbU/edit