<< Back to Twitvid API Documentation

authenticate

Use this method to Authenticate Twitter Username/Password and retrieve a token to use in place of the username and password in the rest of the API calls.

It is strongly recommended that you use this function to retrieve a token and use it in place of the twitter username/password. 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:

• username: Required. Your Twitter username.
• password: Requred. Your Twitter password.

• format: Optional. Select the return type (xml by default)

Usage Notes:

• Your Twitter username and password are required for authentication
• 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>

          </rsp>

          JSON example:

          {"rsp":"ok",

          "status_id":"1111",

          "user_id":"TwitUsername",

          "token":"abcdefabcdefabcdefabcdef",

          "ttl":"360"}

<< Back to Twitvid API Documentation