gettransaction www.recognia.com
recognia/api/gettransaction?

This command enables you to quickly get a transaction id. You can then use this id on subsequent API calls for the same user. Transaction Ids are the prefered method of authenticating a user. You can build web pages with transaction ids instead of the client/user/password trio. This means you don't need to place the user's password in the URL (which is not encrypted when using SSL) or embed the user's password in a hidden field in an HTML form (which a view source will reveal).

The Recognia API authenticates each call. Every time you make an API call, you need to supply a Client Id, User Id, and Password. A transaction id is assigned to the call and included in the header block returned in the XML. This transaction id can be used on subsequent API calls for the same user. The API will pull the client and user information from the transaction id, verify the user is still valid, and process the command. There is a slight performance gain when Transaction Ids are used instead the client/user/password parameters.

Parameters
Name Type Required Default Description
aut Integer false 1

Specify the type of authentication id to return. This parameter takes one of three values:
Value Description
1

This is the default value. A standard style authentication id is returned.
2

This value causes the API to return a new style of authentication id. This id expires after 48 hours regardless of the number of times it is used. Authenticating a user with this type of id is substantially faster than the default style of authentication id and it is strongly recommended that all calls use this new form of authentication.


Return

The XML return only contains the <header block>. You can pull the Transaction Id from the <transaction> tag.