API Token
- Michael Jørgensen
A WinKAS token is a unique and encrypted key, which has a standard expiration time of 12 hours, after which the token becomes inactive. The expiration of a token can be changed by contacting development manager Michael Jørgensen on this email. (OBS: A token can have a maximum expiration of 24 hours.)
Token life cycle
We expect integrators to use the same token during its lifetime and therefore “Not” authorize new tokens until it is absolutely necessary.
Below are a number of different token methods that can be used by integrators.
Validate token
Description:
This method will validate if current token is active.
Url: https://air.winkas.net/api/Authentication/Validate?token=
Requesttype: Get
Response example:
{
"AuthenticationMessage": "Token validation result is: True",
"WinKasData": null,
"WinkasErrorCode": 0,
"WinKasStatus": 0,
"WinKasStatusString": "Okay",
"WinKasMessage": "Token validation was successful.",
"ApiVersion": "5.67.2.1",
"ResponseDateTime": "2022-03-21T11:34:32",
"ResponseInfo": {
"ElapsedSeconds": 0.05,
"ServerName": "WINKAS-AIRWEB02"
},
"Source": null
}
Refetch token
Description:
This method will refetch last active token. Requires authentication information.
Url: https://air.winkas.net//api/authentication/refetchToken/
Requesttype: POST
Requestbody:
{"ContractId":"","Username":"","Password":""}Response example:
{
"Token": "U1vTDs062o1iadVMJK72-nblIDVDB|86VbN3h7sSiW9QOZMrofSKw|xPE3Y3mHX7tU8U-jI-pZPJTiWlTI8n|nX45nUweWqh89gaPthYa|lTDEDqXc2ISwsoK-aWL9wL1C2rPS1onwa8|j1PouTZjxLi|SdGisCQqspzYy3jerLaUikSS|Q5VrN23a|cIqtxe|HDCOyb5B-CeyjVTkTwTl6yiQ92nkvJq43oSxP7-crg_",
"WinkasErrorCode": 0,
"WinKasStatus": 0,
"WinKasStatusString": "Okay",
"WinKasMessage": "Returned the active token",
"ApiVersion": "5.67.2.1",
"ResponseDateTime": "2022-03-21T11:48:39",
"ResponseInfo": {
"ElapsedSeconds": 0.08,
"ServerName": "WINKAS-AIRWEB02"
},
"Source": null
}