Authentication And Security

 

Introduction / Authentication And Security

 

Token

The client needs to provide Token security at the header of each request for authentication.



Request

To request a Token from AppSpace, you required to construct the following:

URL: "http://{your-server-url}/api/v1/ token/request"
Method: GET

Request Headers

content-type:application/json or content-type:application/xml  

Request Body

Request Xml body

<TokenRequest xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages.Token" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><Authentication xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages"><API>String</API><Password>String</Password><SecurityToken>String</SecurityToken><Username>String</Username></Authentication></TokenRequest>

Request Json body

{
	"Authentication":{
		"Password":"{YOUR PASSWORD}",
		"Username":"{YOUR USERNAME}"
	}
}

For more details please visit: TokenService/CreateToken





Response

The server will response with the following object

Response Xml body

<TokenResponse xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages.Token" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><SecurityToken>String</SecurityToken></TokenResponse>

Response Json body

{
	"Errors":[{
		"Code":"String content",
		"Message":"String content",
		"StackTrace":"String content"
	}],
	"Status":0, 
	"SecurityToken":"xxxx-xxxx-xxxx-xxxx"
}

For more details please visit: TokenService/CreateToken



Notice: Please refer the status code, and errors only will be populated if there is any error occurred during the request.