| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

authenticate

Page history last edited by Twitvid Support 11 years, 8 months ago

<< 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.