<< Back to Twitvid API Documentation
authenticate
Use this method to Authenticate using Twitter OAuth and retrieve a token to use in the rest of the API calls.
It is strongly recommended that you use this function to retrieve a token. This mechanism provides more security to the end-user.
URL:
https://im.twitvid.com/api/authenticate
Formats:
xml, json
HTTP Method:
POST
Requires Authentication:
true
Parameters:
Usage Notes:
- A token is returned. This token can be used in place of twitter credentials in other calls, such as upload
- A Time-To-Live (TTL) is also returned, in minutes. This indicates the amount of time the token is valid before a new Authentication call has be made to obtain a new token. The default TTL is 360 minutes.
- Format specifies the desired output format
Response:
XML example:
<?xml version='1.0' encoding='UTF-8'?>
<rsp status='ok'>
<status_id>1111</status_id>
<user_id>TwitUsername</user_id>
<token>abcdefabcdefabcdefabcdef</token>
<ttl>360</ttl>
<profilepic>http://twitvid-image-cache.s3.amazonaws.com/profile_images/victoriajameso.jpg</profilepic>
<user_info>
<twitter_name>victoria jameson</twitter_name>
<twitter_screenname>victoriajameso</twitter_screenname>
<twitter_id>42273969</twitter_id>
<facebook_id>100001968386242</facebook_id>
<facebook_name>Victoria Jameson</facebook_name>
</user_info>
</rsp>
JSON example:
{"rsp":"ok",
"status_id":"1111",
"user_id":"TwitUsername",
"token":"abcdefabcdefabcdefabcdef",
"ttl":"360",
"profilepic":"http://twitvid-image-cache.s3.amazonaws.com/profile_images/victoriajameso.jpg",
"twitter_name":"victoria jameson",
"twitter_screenname":"victoriajameso",
"twitter_id":"42273969",
"facebook_id":"100001968386242",
"facebook_name":"Victoria Jameson"
}
<< Back to Twitvid API Documentation
Comments (0)
You don't have permission to comment on this page.