Authentication
Each request to the API has to be authenticated first. Without authentication your request to the API will fail.
The authentication system takes in the host id and username/password to authenticate. It returns a session token that will be used for subsequent calls into the system. The SessionToken returned will expire if not used within 30 minutes.
Username
You have to log on with a user that is either in the System administrator or Administrator Group.
Host ID
You can lookup the host id in the Administration under Hosts or if you use the Razuna Hosted service under your account page.
Login Method
The Login method is used to login to the system and generate a Session Token restricted to the caller's IP address.
 | As of Razuna 1.3 all passwords are encrypted with the MD5 cryptographic hash function. Thus you have two options. You can either MD5 your password before sending it to the API or send as plain text. The new parameter "passhashed" should be set accordingly! |
Method
| Method Name |
|---|
| login |
| If you are working with our Hosted Platform you can alternatively also use the method called "loginhost"! |
Input Parameter
| Parameter | Description | Type | Required |
|---|---|---|---|
| hostid | This is the host id under which you want to access the assets Use this param instead of "hostname" if you use the method "login" only! |
Numeric | yes |
| hostname | Enter the name of the subdomain, example "joe.razuna.com" Use this param instead of "hostid" if you use the method "loginhost" only! |
String | yes |
| user | A user in the system administrator or administrator group | String | yes |
| pass | The password of the user | String | yes |
| passhashed | Password is MD5 encrypted or not | Numeric | 1 = true 0 = false |
Output Value
| Name | Description | Sample Output |
|---|---|---|
| Response | A result code with the status of the login. If the result is 0 the method was successful. | 0 |
| SessionToken | A token that represents the logged in user. | 54592180-7060-4D4B-BC74-2566F4B2F943 |
SOAP: Sample Request
REST: Sample Request
Sample Output
Labels:
None
Add Comment