POST | /api/v1/login | Login to the Secure Messaging Api using a username and password. If trying to use an Authentication key, use the Authenticate operation instead. | |
---|---|---|---|
POST | /api/login |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Username | body | string | Yes | |
Password | body | string | Yes | |
Cookieless | body | boolean | No | Determines whether session-token should be set in the Cookies. Defaults to false.Allowable Values
|
MfaId | body | integer | No | |
MfaCode | body | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
ResponseStatus | form | ResponseStatus | No | |
SessionToken | body | string | Yes | |
UserServiceGuid | body | string | No | |
Result | body | LoginResult | Yes | |
AvailableMfa | body | List<UserMfa> | Yes | |
AllowedMfaTypes | body | List<MfaType> | Yes |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | int | No | |
Name | form | string | No | |
MfaType | form | int | No | |
Active | form | bool | No | |
PhoneNumber | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /json/reply/Login HTTP/1.1
Host: cirius10.secure-messaging.com
Content-Type: application/json
Content-Length: length
{"username":"String","password":"String","cookieless":false,"mfaId":0,"mfaCode":"String"}
HTTP/1.1 200 OK Content-Type: application/json Content-Length: length {"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}},"sessionToken":"String","userServiceGuid":"String","result":"Success","availableMfa":[{"id":0,"name":"String","mfaType":0,"active":false,"phoneNumber":"String"}],"allowedMfaTypes":["Sms"]}