| POST | /api/authentication/token | Get Bearer access token, contact support for credentials |
|---|
import Foundation
import ServiceStack
/**
* Auth
*/
// @Api(Description="Auth")
// @ApiResponse(Description="Access token response", IsDefaultResponse=true, StatusCode=200)
public class GetAuthToken : Codable
{
/**
* Post parameters in body
*/
// @ApiMember(Description="Post parameters in body", ParameterType="model")
public var clientId:String
/**
* Post parameters in body
*/
// @ApiMember(Description="Post parameters in body", ParameterType="model")
public var clientSecret:String
/**
* Post parameters in body
*/
// @ApiMember(Description="Post parameters in body", ParameterType="model")
public var scope:String
required public init(){}
}
public class AccessTokenResponse : Codable
{
public var accessToken:String
public var scope:String
public var tokenType:String
public var expiresIn:Int
public var httpStatusCode:Int
public var httpErrorReason:String
public var error:String
required public init(){}
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /api/authentication/token HTTP/1.1
Host: stf-api-uat.data-xchange.co.za
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<GetAuthToken xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DX.STF.Application.ClientApi.Messages.Authentication">
<ClientId>String</ClientId>
<ClientSecret>String</ClientSecret>
<Scope>String</Scope>
</GetAuthToken>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <AccessTokenResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DX.STF.Application.ClientApi.ResponseMessages.Authentication"> <AccessToken>String</AccessToken> <Error>String</Error> <ExpiresIn>0</ExpiresIn> <HttpErrorReason>String</HttpErrorReason> <HttpStatusCode>0</HttpStatusCode> <Scope>String</Scope> <TokenType>String</TokenType> </AccessTokenResponse>