 |
TURL_SendAuthorizationPIN |
This will send the PIN (obtained while granting access) to the web service to complete the authorization.
Syntax
TURL_SendAuthorizationPIN ( switches ; method ; accessTokenURL ; PIN )
Parameters
| switches | determine the behaviour of the function |
| method | either POST or GET |
| accessTokenURL | URL to obtain the final access token (and access token secret) from the web service |
| PIN | the PIN (obtained by the user while granting access) |
Switches
switches must be set to:
| -OAuthProtocol | the plug-in is using the OAuth protocol |
you can also use:
| -ReturnDataAfterError | return the error code followed by the data |
Returned Result
Data type returned
text
Result
If successful this function returns several named parameters separated by ampersands. In this result are the two credentials access_token and access_token_secret
Originated in
Troi URL Plug-in 2.6
Compatibility
FileMaker Pro 16 to 19
Considerations
This function provides the second step and completes the authorization.
The plug-in currently only supports the OAuth 1.0A Authorization protocol.
The credentials access_token and access_token_secret need to be stored, to be able to perform requests in the future. Normally you can keep using these two credentials, until the user revokes them (on the web service site). Take care to keep the credentials secret, as they are tied to the userID on the web service.
Example
Set Variable [ $PIN ; "123456" ]
Set Variable [ $Twitter_Access_token_step_URL ; "https://api.twitter.com/oauth/access_token" ]
#send the PIN to Twitter to complete the authorization:
Set Variable [ $Twitter_Result ; TURL_SendAuthorizationPIN ( "-OAuthProtocol" ; "POST" ;
$Twitter_Access_token_step_URL ; $PIN ) ]if succesfull $Twitter_Result will be like:
oauth_token=123456-1w4FgHt&oauth_token_secret=SN4M6F99GG&user_id=12345&screen_name=troiSee the example on how to parse this into separate fields.
Related functions
| TURL_GetAuthorizationURL |
| TURL_SendAuthorizedRequest |
| TURL_SetAuthCredentials |
Related script step
| Send Authorization PIN URL |
Related topics
Troi URL Plug-in online help (overview)
