Login

Authentication

Authentication Process
Documentations

Documentations for API

End Points

https://dev.mfscode.com/zconnect/api/v2/login

Http Method

POST

Header

Name Type Values Description

Request Parameters

Name Description Required Parameter Type Length Sample Value
username Enter valid username. Mandatory String 20 emilys
password Enter valid password. Mandatory STRING 20 emilyspass
expiresInMins Expiry Time. Mandatory INT 2 30

Sample Request

{
    "password": "emilyspass",
    "username": "emilys",
    "expiresInMins": 30
}

Response Parameters

Name Description Parameter Type Length Sample Value
accessToken Access Token STRING 500 eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwidXNlcm5hbWUiOiJlbWlseXMiLCJlbWFpbCI6ImVtaWx5LmpvaG5zb25AeC5kdW1teWpzb24uY29tIiwiZmlyc3ROYW1lIjoiRW1pbHkiLCJsYXN0TmFtZSI6IkpvaG5zb24iLCJnZW5kZXIiOiJmZW1hbGUiLCJpbWFnZSI6Imh0dHBzOi8vZHVtbXlqc29uLmNvbS9pY29uL2VtaWx5cy8xMjgiLCJpYXQiOjE3Mzc0ODM1MTAsImV4cCI6MTczNzQ4NTMxMH0.k8yGmoRTODyvwPwiZET1IDi69dvS7PYAFBbAjNa2tPQ
refreshToken Refresh Token STRING 500 eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwidXNlcm5hbWUiOiJlbWlseXMiLCJlbWFpbCI6ImVtaWx5LmpvaG5zb25AeC5kdW1teWpzb24uY29tIiwiZmlyc3ROYW1lIjoiRW1pbHkiLCJsYXN0TmFtZSI6IkpvaG5zb24iLCJnZW5kZXIiOiJmZW1hbGUiLCJpbWFnZSI6Imh0dHBzOi8vZHVtbXlqc29uLmNvbS9pY29uL2VtaWx5cy8xMjgiLCJpYXQiOjE3Mzc0ODM1MTAsImV4cCI6MTc0MDA3NTUxMH0.zBVdZAB6BXhZSZuk1msID39HPkvETEUWqoFnJ3ELBBo

Response Sample

{
    "firstName": "Emily",
    "lastName": "Johnson",
    "image": "https:\/\/dummyjson.com\/icon\/emilys\/128",
    "gender": "female",
    "id": 1,
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwidXNlcm5hbWUiOiJlbWlseXMiLCJlbWFpbCI6ImVtaWx5LmpvaG5zb25AeC5kdW1teWpzb24uY29tIiwiZmlyc3ROYW1lIjoiRW1pbHkiLCJsYXN0TmFtZSI6IkpvaG5zb24iLCJnZW5kZXIiOiJmZW1hbGUiLCJpbWFnZSI6Imh0dHBzOi8vZHVtbXlqc29uLmNvbS9pY29uL2VtaWx5cy8xMjgiLCJpYXQiOjE3Mzc0ODM1MTAsImV4cCI6MTczNzQ4NTMxMH0.k8yGmoRTODyvwPwiZET1IDi69dvS7PYAFBbAjNa2tPQ",
    "email": "emily.johnson@x.dummyjson.com",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwidXNlcm5hbWUiOiJlbWlseXMiLCJlbWFpbCI6ImVtaWx5LmpvaG5zb25AeC5kdW1teWpzb24uY29tIiwiZmlyc3ROYW1lIjoiRW1pbHkiLCJsYXN0TmFtZSI6IkpvaG5zb24iLCJnZW5kZXIiOiJmZW1hbGUiLCJpbWFnZSI6Imh0dHBzOi8vZHVtbXlqc29uLmNvbS9pY29uL2VtaWx5cy8xMjgiLCJpYXQiOjE3Mzc0ODM1MTAsImV4cCI6MTc0MDA3NTUxMH0.zBVdZAB6BXhZSZuk1msID39HPkvETEUWqoFnJ3ELBBo",
    "username": "emilys"
}
Here Java Code

Response Code Details

{
    "firstName": "Emily",
    "lastName": "Johnson",
    "image": "https:\/\/dummyjson.com\/icon\/emilys\/128",
    "gender": "female",
    "id": 1,
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwidXNlcm5hbWUiOiJlbWlseXMiLCJlbWFpbCI6ImVtaWx5LmpvaG5zb25AeC5kdW1teWpzb24uY29tIiwiZmlyc3ROYW1lIjoiRW1pbHkiLCJsYXN0TmFtZSI6IkpvaG5zb24iLCJnZW5kZXIiOiJmZW1hbGUiLCJpbWFnZSI6Imh0dHBzOi8vZHVtbXlqc29uLmNvbS9pY29uL2VtaWx5cy8xMjgiLCJpYXQiOjE3Mzc0ODM1MTAsImV4cCI6MTczNzQ4NTMxMH0.k8yGmoRTODyvwPwiZET1IDi69dvS7PYAFBbAjNa2tPQ",
    "email": "emily.johnson@x.dummyjson.com",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwidXNlcm5hbWUiOiJlbWlseXMiLCJlbWFpbCI6ImVtaWx5LmpvaG5zb25AeC5kdW1teWpzb24uY29tIiwiZmlyc3ROYW1lIjoiRW1pbHkiLCJsYXN0TmFtZSI6IkpvaG5zb24iLCJnZW5kZXIiOiJmZW1hbGUiLCJpbWFnZSI6Imh0dHBzOi8vZHVtbXlqc29uLmNvbS9pY29uL2VtaWx5cy8xMjgiLCJpYXQiOjE3Mzc0ODM1MTAsImV4cCI6MTc0MDA3NTUxMH0.zBVdZAB6BXhZSZuk1msID39HPkvETEUWqoFnJ3ELBBo",
    "username": "emilys"
}
{
    "messages": "Bad Request - Invalid Access Token",
    "errorcode": "4001"
}

{
    "messages": "Bad Request - Invalid Request Payload",
    "errorcode": "4002"
}

{
    "messages": "Bad Request - Invalid Authorization Header",
    "errorcode": "4003"
}

{
    "messages": "Something Went Wrong",
    "errorcode": "4004"
}

{
    "messages": "Record Not Found",
    "errorcode": "4005"
}

{
    "messages": "Invalid Client Id\/Secret",
    "errorcode": "4006"
}

{
    "messages": "Bad Request - Invalid Access Token",
    "errorcode": "4007"
}

Try out yourself

Security

X-IBM-Client-Id(apiKey located in header)
X-IBM-Client-Secret(apiKey located in header)
1c48aa28-2614-486f-aa2c-cbc86cc7ab51

Header Parameter

Name Values Description
Content-Type application/json Content Type application/json is supported
Accept application/json Content Type application/json is supported
organizationId xyz You will make a call to the auth-blb api and give it your client ID. You should add the client secret and organization ID it returns here.
clientId Enter your verified Client Id
clientSecret Enter Your Verified Client Secret

Request Body

Copy

Response Body

Copy